Apecsoft也是一种情怀

Codex国内部署全流程:从下载到跑通,手把手教你10分钟搞定


🚀 还在羡慕别人用AI辅助工作?这篇教程从下载软件开始,手把手教你10分钟搞定Codex,每一步都有图有真相,照着做就行。


写在前面:Codex到底是什么?

2026年,AI编程圈最火的名字,没有之一——Codex

OpenAI官方出品的AI编程智能体,GitHub Star突破83,200+。和普通ChatGPT不同,它能直接读你的文件、改你的代码、跑你的命令

打个比方:

  • ChatGPT
    像一个电话客服,你说它答,但帮不了你动手
  • Codex
    像一个坐在你旁边的实习生,你说需求,它打开文件、写代码、跑测试、查Bug

更关键的是,它不只是程序员工具。产品经理整理文档、运营清洗Excel、学生做课设——只要你能用大白话描述需求,Codex就能帮你干活。

但国内用户面临一个现实问题:Codex默认连的是OpenAI官方服务器,国内无法直接访问。

很多新手卡在”装好了却用不了”,最终放弃。其实,整个部署过程拆开来看并不复杂——下载环境、安装软件、配置文件,三步走完就能跑通。

这篇教程,就是写给从零开始、还不会用Codex的你

▲ Codex部署全流程:下载→安装→配置→启动


📋第一阶段:下载并安装Codex

Codex有三种使用方式,适合不同人群:

方式
适合谁
特点
桌面App
零基础新手、办公用户
图形界面,像用微信一样简单
CLI命令行
开发者、终端熟练者
灵活度最高,进项目目录一条命令启动
VS Code插件
习惯编辑器写代码的人
编辑器内直接用,不用切窗口

下面分别讲解安装方法。新手建议从桌面App开始,先体验起来,再进阶CLI。

方式一:安装Codex桌面App(推荐新手)

Windows安装

方法A:通过微软商店安装(最简单)

  1. 打开 Microsoft Store(微软商店)
  2. 搜索 Codex
  3. 找到OpenAI官方发布的Codex应用
  4. 点击 获取/下载,等待自动安装

也可以直接访问微软商店网页版安装:https://apps.microsoft.com/detail/9plm9xgg6vks

还可以直接访问Codex官网进行下载安装: ttps://openai.com/zh-Hans-CN/codex/


安装到D盘小技巧:Codex默认装在C盘。如果想装到D盘,先去 Windows设置 → 系统 → 存储 → 更改新内容的保存位置,把”新的应用将保存到”改为D盘,再安装。

Mac安装

  1. 打开 App Store
  2. 搜索 Codex
  3. 点击下载安装

或者从官网下载 .dmg 文件,双击打开,把Codex拖入”应用程序”文件夹即可。

设置中文界面(可选)

首次打开通常是英文,切换中文:

  1. 点击菜单 File → Settings
  2. 进入 General
  3. 找到 Language for the app UI
  4. 选择 Chinese (China)
  5. 重启Codex

语言包需要联网下载,切换后没反应的话检查网络。


📋第二阶段:核心问题梳理

为什么需要 CC Switch?

先说一个很多新手不知道的事实 👇

Codex 原生只认 OpenAI 的协议,国产模型用的协议和它不一样,两者直接对接是连不上的。

这就好比你的手机是 Type-C 接口,充电器却是 Lightning——硬件都好好的,就是接口不匹配。

CC Switch 做的事情,就像一个 协议转换器:在本地启动一个轻量代理,把 Codex 发出的请求自动翻译成国产模型能听懂的格式,再把返回结果翻译回 Codex 能识别的格式。

全程透明,Codex 以为自己在连 OpenAI,实际请求已经飞到了国产模型。

▲ CC Switch 工作原理:Codex → 本地代理 → 国产模型 → 原路返回


这样做的好处非常直接:

对比项
❌ 不用 CC Switch
✅ 用 CC Switch
切换模型
手动改config.toml,重启终端
点一下鼠标,秒切
配置文件
手写 JSON/TOML,容易出错
自动写入,零代码
使用成本
需 OpenAI 订阅($20/月)
国产模型免费额度/按量付费
网络稳定性
需翻墙,经常掉线
国内直连,低延迟
多工具管理
每个工具单独配
Claude/Codex/Gemini 统一管

目前 CC Switch 支持接入 22 家国产模型:DeepSeek、智谱 GLM、Kimi、MiniMax、豆包 Seed、百度千帆、通义千问、StepFun 等,基本覆盖了主流国产大模型。

📦三种方案对比,选最适合你的

方案
成本
难度
适合人群
API中转
按量付费
⭐⭐
想用GPT系列模型的人
CC Switch + DeepSeek
免费/极低
⭐⭐⭐
预算有限,想用国产模型
ChatGPT账号登录
$20/月
有ChatGPT Plus账号的人

我的建议:第一次尝试,先用方案B(CC Switch + DeepSeek)跑通流程,虽然过程看起来略复杂,但是跟着教程走,一般没什么问题。熟悉之后再根据需求切换到方案A,或方案C获得最完整体验,毕竟这里涉及到科学上网。

(PS:博主就是这么摸索过来的,当初踩过的弯路,自然也会让大家亲身感受一遍😄。不过话说回来,把这一关吃透之后,后续上手其他玩法,基本就能顺顺利利了。

📋第三阶段:配置国内API接入(核心步骤)

这是整个流程中最关键也最容易卡住的一步。Codex默认连接OpenAI官方服务器,国内无法直连。解决方法:修改配置文件,把请求指向国内可用的API端点。

方式A:直连API中转(最快捷,推荐首次使用)

第一步:获取API Key(以DeepSeek为例)

1.搜索DeepSeek官网,并登陆

2.进入官网后,点击API开放平台

3.进入开放平台登陆界面

4.左侧栏选择API key,右侧页面点击创建API key按钮

5.点击 创建APIkey按钮后,可以给即将创建的API key命名,便于自己可以分辨。

6.点击 创建 按钮这样我们的API key就创建成功了,复制生成的 sk-xxx 格式密钥,保存好(特别提示:这个key一定要单独保存到安全的地方,如关闭此对话框之后,将无法再次查看,中间会被*代替

⚠️ Key只完整显示一次,创建后立即复制保存!


📋第四阶段:配置CC Switch + 国产模型,接入Codex(核心步骤)

优点:(免费/低成本方案)

如果不想花钱买GPT模型,可以用 CC Switch 这个免费开源工具,把Codex接入DeepSeek等国产模型。

原理很简单:

Codex → CC Switch(本地代理) → DeepSeek/Qwen/GLM → 返回结果

Codex以为自己在访问OpenAI,实际上请求已经被转发到了国产模型。

▲ CC Switch:一键切换Codex背后的AI模型

安装CC Switch

  1. 前往GitHub下载:https://github.com/farion1231/cc-switch/releases/latest
  2. 也可以前往CC Swith官网进行跳转GitHub下载:https://www.ccswitch.io/zh/
  3. 根据系统选择安装包:
  • Windows
    :下载 .msi,双击安装
  • Mac
    :下载 .dmg,拖入应用程序文件夹
  • Linux
    :下载 .deb,执行 sudo dpkg -i CC-Switch-*.deb

配置DeepSeek(有免费额度)

  1. 在 DeepSeek开放平台 注册并创建API Key
  2. 打开CC Switch,顶部切换到 Codex
  3. 点击左侧 + Add Provider
  4. 搜索并选择 DeepSeek 预设
  5. 填入你的DeepSeek API Key
  6. 开启本地路由映射,保存
  7. 点击左上角设置,进入路由设置,开启路由,选择Codex
完成后重新打开Codex,就能使用DeepSeek的模型了。免费额度日常使用基本够用。

📋第五阶段:验证与第一次使用

桌面App验证

  1. 打开Codex Desktop
  2. 在对话框输入 hello
  3. 能正常收到回复 → 配置成功

全流程回顾:一张图看懂

整个部署过程,其实就是五步:

总计约10分钟,你就拥有了一个AI办公搭子。

写在最后

部署Codex这件事,根本就不难,只需要根据这篇”从下载软件开始”的保姆级教程,一步一步走下来,10分钟就搞定啦!

AI不会取代你,但会用AI的人会。

现在,打开浏览器,然后跟着这篇教程一步步来。

10分钟后,你会感谢今天动手的自己。


参考资料

OpenAI Codex官方文档:https://developers.openai.com/codex
  1. Codex Desktop微软商店:https://apps.microsoft.com/detail/9plm9xgg6vks
  2. CC Switch开源项目:https://github.com/farion1231/cc-switch
  3. DeepSeek开放平台:https://platform.deepseek.com/

本文基于2026年6月最新公开资料整理,部分功能可能随版本更新而变化,请以官方信息为准。

未经允许不得转载:阿帕克软件-Apecsoft » Codex国内部署全流程:从下载到跑通,手把手教你10分钟搞定