如何安装 Codex，并用 CC-Switch 配置 API Key

安装 Codex CLI，API Key 交给 CC-Switch 管理。以下命令在 PowerShell 执行，配置以 DeepSeek 官方 API 为例。

先选路线#

你的情况	建议
已有可用的 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 账号	直接运行 `codex`，选择 Sign in with ChatGPT；通常不需要 CC-Switch
只有 OpenAI API Key	可以直接配置 Codex，也可以交给 CC-Switch 管理
需要在多个官方或第三方接口之间切换	使用 CC-Switch
接口只支持 Chat Completions，不支持 Responses API	使用 CC-Switch 的对应预设或本地路由映射

安装 Codex CLI#

Windows：官方独立安装脚本#

1
powershell -ExecutionPolicy Bypass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

默认从 OpenAI 发布地址下载，必要时回退 GitHub Releases。重开终端：

1
codex --version
2
codex

首次启动选 Sign in with ChatGPT 或 API Key。

Windows：npm 安装#

1
node --version
2
npm --version
3
npm install -g @openai/codex
4
codex --version

Node.js 16+。下载慢换镜像：

1
npm install -g @openai/codex --registry=https://registry.npmmirror.com

镜像只管包下载，不代理模型请求，不解决 Base URL 或登录。

macOS 与 Linux#

1
brew install --cask codex

1
curl -fsSL https://chatgpt.com/codex/install.sh | sh

或手动下载 OpenAI Codex Releases 对应架构稳定版。

桌面端：Codex 已并入 ChatGPT 桌面应用#

ChatGPT 桌面应用已内置 Codex，不用另装 App。官方下载，或：

1
winget install --id 9PLM9XGG6VKS -s msstore

桌面应用、CLI、IDE 扩展共用 %USERPROFILE%\.codex 和 config.toml。CC-Switch 写入的配置桌面链路可读。

可选：安装中文版 Codex CLI#

Codex-Cli-Ultra：简体中文语言包 + Windows 安装管理 + 可选终端界面扩展。

1
npm install -g @openai/codex

下载 Releases Windows x64 ZIP 和 .sha256，校验：

1
Get-FileHash .\codex-cli-ultra-v*-windows-x64.zip -Algorithm SHA256
2
Get-Content .\codex-cli-ultra-v*-windows-x64.zip.sha256

一致后解压运行：

1
.\install.cmd

验证：

1
codex --version
2
codex --i18n-self-check

恢复官方版：

1
codex-ultra uninstall

安装 CC-Switch#

第三方开源配置管理工具，保存多个供应商配置，把当前启用的写入各 CLI 实际配置文件。

Windows 10+：

CC-Switch-v{版本号}-Windows.msi：安装版
CC-Switch-v{版本号}-Windows-Portable.zip：绿色版

macOS：

1
brew install --cask cc-switch

首次启动可导入已有 Codex 配置为默认供应商。

以 DeepSeek 官方 API 为例#

接口信息以 DeepSeek API 中文文档为准。

1. 创建 DeepSeek API Key#

打开 DeepSeek 开放平台登录。API 单独计费，先确认余额。

左侧 API keys → 创建 API key。名称写清用途，如 “Codex-CC-Switch”。

创建后立即复制保存，Key 只显示一次。

Key 不进截图、Git 仓库、聊天记录或公开文章。

2. 在 CC-Switch 中添加 DeepSeek#

切到 Codex → 右上角 +。

有 DeepSeek 预设就优先用：

粘贴 API Key；
点击 获取模型；
从返回结果里选真实存在的模型 ID；
保存供应商。

DeepSeek 模型列表会调整，以”获取模型”返回的 ID 为准。写本文时官方列了 deepseek-v4-flash、deepseek-v4-pro。

没预设就自定义：

字段	内容
名称	DeepSeek
API Key	刚创建的 DeepSeek Key
Base URL	https://api.deepseek.com
API 格式	OpenAI Responses API
模型	点击”获取模型”后选择
需要本地路由映射	关闭（原生 Responses，无需转换）

Base URL 填服务根地址，别拼 /chat/completions。

3. Codex 与 DeepSeek 当前使用什么协议#

截至修订时，Codex 配置参考：wire_api 只支持 responses，省略也默认 responses。DeepSeek 现已提供原生 Responses API（官方文档），示例请求 Base URL 为 https://api.deepseek.com。当前 deepseek-v4-flash 已支持，deepseek-v4-pro 也已加入。

结论：

Codex 自定义 Provider 端使用 Responses API；
DeepSeek 已支持原生 /responses，无需协议转换；
配置 Base URL https://api.deepseek.com 即可直连，不需要 CC-Switch 本地路由。

只有服务商只提供 Chat Completions 时，才需要 CC-Switch 做协议转换。

4. 本地路由（仅 Chat Completions 服务商需要）#

DeepSeek 原生支持 Responses API 后，Codex 直连即可，不需要本地路由。

服务商只提供 /chat/completions 时才需要：

CC-Switch → 设置 → 路由 → 本地路由：

打开路由总开关；
在”路由启用”中打开 Codex；
回 Codex 供应商列表，启用该服务商。

CC-Switch 让 Codex 连本机路由，把 Responses 请求转成 Chat Completions，再把响应转回。别手动把 wire_api 改成 chat。

切完重开 ChatGPT 桌面应用和 Codex CLI，发测试请求，确认用量页请求次数或 Token 增长。

CC-Switch 的通用配置方法#

1. 选择 Codex#

打开 CC-Switch → 应用列表选 Codex → 右上角 +。

有预设就优先用，预设自动填协议、端点、路由方式。没预设就自定义。

2. 填写供应商信息#

字段	怎么填
名称	就是名字
API Key	从服务商控制台复制
Base URL	服务商给出的 API 根地址，OPENAI 格式通常以 `/v1` 结尾
模型	服务商实际支持的模型 ID，可点获取模型看列表
API 协议	优先原生 Responses API；只有 Chat Completions 的接口需要本地路由映射

点模型输入框旁的 获取模型。401/403 一般是 Key 不对。

3. 分清 Responses 与 Chat Completions#

Codex 原生工作流用 Responses API。供应商原生支持 /responses 就直接连。

只提供 /chat/completions 时，别把 wire_api 改成 chat。选 CC-Switch 对应的 Chat Completions 预设，或开启 需要本地路由映射。

最常见的配置错误：Base URL 能打开、Key 也没错，但服务端没实现 Responses 协议。

4. 保存并启用#

保存后在卡片点启用。看到”当前启用”后，重开终端，再运行：

1
codex

CC-Switch 的供应商切换不是当前会话热更新。旧终端或旧进程可能还在用切换前的配置。

CC-Switch 实际改了什么#

Windows 上，Codex 默认读取：

1
%USERPROFILE%\.codex\auth.json
2
%USERPROFILE%\.codex\config.toml

API Key 在 auth.json：

1
{
2
  "OPENAI_API_KEY": "YOUR_API_KEY"
3
}

模型和端点写在 config.toml。原生 Responses 供应商大致如下：

1
model_provider = "custom"
2
model = "provider-model-id"
3
model_reasoning_effort = "high"
4
disable_response_storage = true
5

6
[model_providers.custom]
7
name = "custom"
8
base_url = "https://api.example.com/v1"
9
wire_api = "responses"
10
requires_openai_auth = true

仅供参考，别原样复制示例地址和模型。用 CC-Switch 创建供应商，让它按表单和预设生成。Chat Completions 路由模式下，配置还会指向 CC-Switch 的本地代理。

CC-Switch 把供应商数据存在 ~/.cc-switch/cc-switch.db，并保留自动备份。因此：

不要把 .codex 或 .cc-switch 目录提交到 Git；
不要把 API Key 截进教程图片、终端记录或错误日志；
不要把含 Key 的配置备份发给别人。

验证配置#

1
Get-Command codex | Format-List Source
2
codex --version
3
codex login status
4
codex doctor

最后运行 codex，发个很小的测试请求。能进界面只说明装好了；请求实际返回，才证明 Base URL、API Key、协议和模型都匹配。

常见问题#

401 或 403#

API Key 是否复制完整；
是否误带空格、引号或 Bearer ；
Key 是否属于当前 Base URL 对应的平台；
账号是否还有额度或调用权限。

404、405，或提示 Responses 不支持#

Base URL 别直接填具体请求路径；
确认服务商是否真的支持 Responses API；
只有 Chat Completions 时，启用 CC-Switch 本地路由映射。

切换后仍然请求旧地址#

先完全退出 Codex，开新终端。再查环境变量是否覆盖配置文件（只返回 True/False，不打印 Key）：

1
[bool]$env:OPENAI_API_KEY
2
[Environment]::GetEnvironmentVariable("OPENAI_API_KEY", "User") -ne $null
3
[Environment]::GetEnvironmentVariable("OPENAI_API_KEY", "Machine") -ne $null

CC-Switch 顶部出现”环境变量冲突”警告，先查变量来源再决定删不删。被删的变量备份在 ~/.cc-switch/env-backups/。

明明更新了，运行的还是旧版本#

Windows 上可能同时有 npm、官方独立安装器和 Codex-Cli-Ultra 的入口：

1
where.exe codex
2
Get-Command codex -All | Select-Object Source

看 PATH 中最先命中哪个。装 Codex-Cli-Ultra 后出现它自己的启动器是正常的；卸载用 codex-ultra uninstall 恢复官方入口。

音乐

音乐