国内也能用 Codex:安装教程 + DeepSeek 接入

国内也能用 Codex

安装教程 + DeepSeek 接入 · 从零开始

不用 ChatGPT 付费账号，不需要官方登录，接 DeepSeek API 是目前上手成本比较低的一条路。

CLI 和桌面版不是一回事。 CLI 就是在终端里使用 codex，轻、验证快。桌面版有图形界面，看 diff 更直观。配置目录可共用：Mac/Linux 在 ~/.codex/，Windows 在 C:\Users\你的用户名\.codex\。

接国产模型为什么会踩坑。 新版 Codex 默认走 Responses API，不是老的 Chat Completions。很多平台只支持后者，随便改 base_url 容易 404。DeepSeek 官方已做对接，下文按推荐路径写。

怎么打开终端

后面很多步骤要在「终端」里敲命令。终端就是一个窗口，你输入什么，电脑就执行什么。

Windows：按 Win + S，搜索 PowerShell 或「终端」，点开。看到类似 PS C:\Users\你的用户名> 就对了。也可以在文件夹空白处按住 Shift 点右键，选「在终端中打开」。

Mac：按 Command + 空格，搜索「终端」或 Terminal，回车。看到类似 用户名@MacBook ~ % 就对了。

先确认 Node.js

在终端输入下面两条，看有没有版本号：

node -v npm -v

有版本号（比如 v20.x、10.x）就能继续。没有的话，浏览器打开 nodejs.org，下载 LTS 版本，一路下一步安装。装完关掉终端再开一个新的，重新输入 node -v 确认。

1.1 安装 CLI

打开终端，下面命令可以整段复制粘贴（一次一行也行）：

# 方式 A：官方安装脚本（Mac / Linux 常见） curl -fsSL https://chatgpt.com/codex/install.sh | sh  # 方式 B：npm 全局安装（Windows 也常用） npm install -g @openai/codex  # 验证是否装好 codex --version

Windows 如果方式 A 报错（没有 curl），直接用方式 B。安装问权限就输入 y 回车；若提示权限不足，右键 PowerShell 选「以管理员身份运行」再装。

装完如果找不到 codex，关掉终端重开再试。还不行，执行 npm config get prefix，把该路径加入系统 PATH，或先重启电脑。

1.2 桌面版

安装获取方式：

① 官网安装（需要魔法）： chatgpt.com/codex 

② 社区镜像 Release（不需要魔法），选 win-x64（Windows 64 位）或 mac-arm64（mac）：https://github.com/Wangnov/codex-app-mirror/releases/tag/codex-app-26.820.60940

下载对应包后，双击安装，和装普通软件一样下一步下一步。首次打开若问导入 Claude 配置，直接 Skip。

接入有两种方式：

1、手动配置（mac/linux推荐）2、通过CC-Switch（windows推荐）

2.1 拿 API Key

1. 浏览器打开 platform.deepseek.com，注册或登录

2. 找到 API Keys（或 API 密钥）

3. 点创建 API Key，复制保存（只显示一次）

4. 按平台要求充值，通常少量余额就能试跑

2.2 手动配置（四步）

第一步：建 .codex 文件夹

第二步：新建 config.toml

在 .codex 里新建文件 config.toml。

Windows：先新建文本文档；如果看不到 .txt 后缀，资源管理器「查看」里勾选「文件扩展名」；改名为 config.toml，提示改扩展名点「是」；右键用记事本打开。

Mac：终端执行 open -e ~/.codex/config.toml。

把下面内容完整复制进去，保存：

第三步：写入 API Key（二选一）

方式 A 环境变量（推荐）

Mac：终端执行 open -e ~/.zshrc，最后一行加 export DEEPSEEK_API_KEY="sk-你的密钥"，保存后执行 source ~/.zshrc。

Windows：Win + S 搜「环境变量」→ 编辑账户的环境变量 → 用户变量点「新建」→ 名称 DEEPSEEK_API_KEY，值填 Key → 确定 → 关掉所有 PowerShell 重开。

方式 B auth.json

在 .codex 新建 auth.json，记事本写入密钥，保存。

{"LLM_API_KEY": "sk-你的密钥"}

第四步：重启终端，输入 codex 试一次。环境变量改完不重启，Key 可能还没生效。

2.3 CC-Switch 图形化（Windows 更省事）

1. 浏览器打开 ccswitch.io，下载 Windows 的 msi 安装包

2. 双击安装

3. 打开 CC-Switch，设置里打开 Codex 相关选项

4. 主页点 Codex 图标 → 点 + → 选 DeepSeek → 粘贴 Key → 保存

5.添加完点击 启用

6. 完全退出 Codex（托盘也要退出），再重新打开

桌面版模型下拉看不到项：先用 ChatGPT 登录 Codex 一次（免费账号即可），再在 CC-Switch 打开「保留官方登录」（v3.16.1+）。

打开终端，输入 codex，等界面出来（第一次可能稍慢）。然后输入 /model 看模型列表，或直接问：你是哪个模型？

成功的话，顶部或左下角显示 deepseek-*，能正常回复，不反复逼 ChatGPT 登录。退出一般按 Ctrl + C 两次，或输入 /exit。

DeepSeek 配通后，换平台不用重装 Codex。两条路：手改 config.toml，或用 CC-Switch 点选。

4.1 手改 config.toml

打开 config.toml，主要改：

① model，替换使用的模型

② base_url，替换模型的URL，通常在各个模型官网都有提供

举例：换成阿里云百炼

model_provider = "dashscope"   #使用哪个环境，和[model_providers.xxx] 对应即可model = "qwen3-coder-plus" model_reasoning_effort = "medium"  [model_providers.dashscope]  # 段名 dashscope 必须和上面一致name = "DashScope" base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"wire_api = "responses"env_key = "LLM_API_KEY"

再把 auth.json 或者环境变量 LLM_API_KEY 的值换成百炼 Key，然后重启codex即可。

4.2 用 CC-Switch 换

CC-Switch → 选 Codex → 点 + → 选平台模板 → 填 API Key → 保存 → 点击启用→ 完全退出 Codex 再开 → /model 确认即可。

codex 命令找不到：检查 npm 全局目录是否在 PATH。Windows 新开终端，或重启电脑。

一直弹 ChatGPT 登录：确认 config.toml 里有 preferred_auth_method = "apikey"，Key 已写入，改完重启终端。

404 或 unsupported parameter：协议或 reasoning 参数对不上。优先跑 DeepSeek 官方脚本或对照 toml。

Windows 与 WSL 配置不同步：可在 WSL 的 ~/.bashrc 里设 export CODEX_HOME=/mnt/c/Users/Windows用户名/.codex

Key 泄露：立刻去平台作废重建，auth.json 别往群里扔。

有兴趣的话，也可以到本公众号菜单栏，看看我自己做的小程序～

我是 小火的实验室，热衷于分享小程序与 AI 开发干货

如果你觉得今天这篇有收获，欢迎点赞、在看、转发三连，我们下篇见