Codex 客户端使用指南
安装客户端后，更新 config.toml 配置文件。（可以先备份一下原来的配置文件，然后直接复制以下内容覆盖原有文件全部内容即可。）
- macOS / Linux：
~/.codex/config.toml - Windows：
C:\Users\你的用户名\.codex\config.toml
model_provider = "codexcn"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"
[model_providers.codexcn]
name = "codexcn"
base_url = "https://api2.codexcn.com/v1"
wire_api = "responses"
requires_openai_auth = true
[windows]
sandbox = "elevated"
- 打开 Codex 客户端，进入登录界面
- 选择 其他方式登录
- 选择 API Key 登录
- 输入你购买的 API Key，并确认登录
如果模型选项中还没有显示最新的 GPT-5.6 系列模型，请先完全退出 Codex 客户端，然后删除本地模型缓存文件：
- macOS / Linux：
~/.codex/models_cache.json - Windows：
C:\Users\你的用户名\.codex\models_cache.json
删除后重新启动 Codex 客户端，客户端会自动重新加载模型列表，此时即可看到并选择 GPT-5.6 系列模型。
只需删除 models_cache.json，不要删除整个 ~/.codex 目录，以免影响配置和历史会话。
登录成功后即可在 Codex 客户端中使用 CodexCN API 服务。如果登录失败，请检查 API Key 是否填写完整，以及 config.toml 是否已按示例配置。
CCSwitch 使用指南
打开 CCSwitch，点击右上角的加号按钮，进入添加供应商页面。
在添加供应商页面，选择 Codex 供应商，然后选择 自定义配置。
按下面内容填写供应商信息，API Key 使用你购买后获得的完整 Key，最后点击右下角 添加。
CodexCNhttps://api.codexcn.comsk-...https://api2.codexcn.com/v1
回到主页后，选择刚添加的 codexcn，点击 启用 即可开始使用。
点击测速按钮一定会提示连接失败，这不影响使用；请忽略测速结果，直接打开终端使用即可
恢复历史会话
切换 model_provider 后，历史会话通常没有丢失，只是 Codex 客户端会按 provider 相关 metadata 过滤会话，导致旧会话暂时不可见。把下面这段话复制给 Codex，让它帮你检查本地配置、会话文件和状态数据库，并完成必要的同步。
请帮我恢复 Codex 切换 provider 后不可见的历史会话。
目标 provider 是 codexcn。
请先检查我的 ~/.codex/config.toml、~/.codex/sessions 和 ~/.codex/state_5.sqlite。
执行前请提醒我关闭 Codex Desktop、Codex CLI 或其他正在使用 ~/.codex 的进程。
执行后请告诉我备份目录、恢复命令，以及如何确认历史会话已经重新可见。Codex CLI 使用指南
Codex CLI 需要 Node.js v18 或更高版本。
方法一：使用 Homebrew（推荐）
# 更新 Homebrew
brew update
# 安装 Node.js
brew install node方法二：官网下载
- 访问 nodejs.org 下载 macOS LTS 版本
- 打开
.pkg文件，按安装向导完成
方法一：官网下载（推荐）
- 访问 nodejs.org 下载 LTS 版本
- 双击
.msi文件，按向导安装（保持默认设置）
方法二：使用包管理器
# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs建议使用 PowerShell 而非 CMD，以获得更好的体验。
方法一：使用官方仓库（推荐）
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs方法二：使用系统包管理器
# Ubuntu/Debian
sudo apt update && sudo apt install nodejs npm
# CentOS/RHEL/Fedora
sudo dnf install nodejs npm安装完成后验证：
node --version
npm --version以管理员身份运行 PowerShell，执行：
npm i -g @openai/codex --registry=https://registry.npmmirror.com验证安装：
codex --version需要创建两个配置文件：config.toml 和 auth.json。
配置文件位于 ~/.codex/ 目录（不存在则创建）。
配置文件位于 C:\Users\你的用户名\.codex\ 目录（不存在则创建）。
创建 config.toml 文件：
model_provider = "codexcn"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"
[model_providers.codexcn]
name = "codexcn"
base_url = "https://api2.codexcn.com/v1"
wire_api = "responses"
requires_openai_auth = true
[windows]
sandbox = "elevated"
model_provider = "codexcn"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"
[model_providers.codexcn]
name = "codexcn"
base_url = "https://api2.codexcn.com/v1"
wire_api = "responses"
requires_openai_auth = true
[windows]
sandbox = "elevated"
创建 auth.json 文件：
{
"OPENAI_API_KEY": "your-api-key-here"
}{
"OPENAI_API_KEY": "your-api-key-here"
}将 your-api-key-here 替换为您购买的 API Key。如果还没有 Key，请先前往 定价页 购买。
此方式通过 auth.json 文件存储 API 密钥，config.toml 中无需配置 env_key 字段。
如果你使用 VS Code，可以安装 Codex 扩展获得更好的 IDE 集成体验。
- 在 VS Code 扩展商店搜索并安装 Codex – OpenAI's coding agent
- 确保已按照上述步骤配置好
config.toml和auth.json - 设置环境变量
CODEX_API_KEY为你的 API Key
env_key 只能填写环境变量名称（如 CODEX_API_KEY），不能直接填写密钥值，否则会报错。
在项目目录下运行：
cd /path/to/your/project
codexcd C:\path\to\your\project
codex首次启动时，Codex 会进行初始化配置。如果连接正常，你将看到交互界面。
1. 命令未找到
# 检查 npm 全局安装路径
npm config get prefix
# 如果路径不在 PATH 中，添加到 ~/.zshrc
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc- 确保 npm 全局路径（通常
C:\Users\你的用户名\AppData\Roaming\npm）已添加到系统 PATH - 重新打开 PowerShell 窗口
# 检查 npm 全局安装路径
npm config get prefix
# 如果路径不在 PATH 中，添加到 ~/.bashrc
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc2. API 连接失败
# 测试网络连接
curl -I https://api2.codexcn.com
# 检查配置文件是否正确
cat ~/.codex/config.toml
cat ~/.codex/auth.json# 测试网络连接
Test-NetConnection -ComputerName api2.codexcn.com -Port 443
# 检查配置文件
Get-Content $HOME\.codex\config.toml
Get-Content $HOME\.codex\auth.json3. 更新 Codex CLI
npm i -g @openai/codex --registry=https://registry.npmmirror.com