Codex CLI 配置教程
企业级 AI 编码助手 - 完整部署手册
请先完成 Node.js 环境安装 环境安装 和 CC-Switch 工具 工具安装。
🎯 快速导航
🚀 使用 CC-Switch 快速配置（推荐）
使用 CC-Switch 配置 CodeX 之前，请确保已通过 npm 全局安装 CodeX 工具：
npm install -g @openai/codex@latestcodex --version配置步骤
1. 启动 CC-Switch 并切换到 Codex 标签
2. 填写 CodeX 提供商配置
可以添加多个提供商配置，随时切换
切换配置后，关闭并重启 CodeX 即可生效
3. 启用配置并使用
4. 系统托盘快速切换
CodeX 令牌与 Claude Code 令牌不通用
切换配置后需要重启 CodeX 才能生效
可在 CC-Switch 中测试 API 端点速度
⌨️ 手动命令行配置
🖥️ Windows 平台
第一步：部署 CodeX 命令行工具
npm install -g @openai/codex@latest
codex --version第二步：集成 ZetaRouter API 服务
1.
2.
3.
4.
5.
构建配置目录结构：
mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codexmodel_provider = "ZetaRouter"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
[model_providers.ZetaRouter]
name = "ZetaRouter"
base_url = "https://plan.zetarouter.com/v1"
wire_api = "responses"
requires_openai_auth = true编写认证文件：auth.json
{
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
}第三步：初始化工作空间
mkdir my-codex-project
cd my-codex-project
codex🍏 macOS 平台
部署 CodeX 工具
npm install -g @openai/codex@latest
codex --version集成 API 服务
mkdir -p ~/.codex
cd ~/.codex编写 config.toml 配置：
cat > config.toml << 'EOF'
model_provider = "ZetaRouter"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
[model_providers.ZetaRouter]
name = "ZetaRouter"
base_url = "https://plan.zetarouter.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF编写 auth.json 认证配置：
cat > auth.json << 'EOF'
{
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
}
EOF初始化工作 空间
mkdir my-codex-project
cd my-codex-project
codex🐧 Linux 平台
部署 CodeX 工具
sudo npm install -g @openai/codex@latest
codex --version集成 API 服务
mkdir -p ~/.codex
cd ~/.codex编写 config.toml 配置：
cat > config.toml << 'EOF'
model_provider = "ZetaRouter"
model = "gpt-5.5"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
[model_providers.ZetaRouter]
name = "ZetaRouter"
base_url = "https://plan.zetarouter.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF编写 auth.json 认证配置：
cat > auth.json << 'EOF'
{
"OPENAI_API_KEY": "此处粘贴您的 CodeX 专用令牌"
}
EOF初始化工作空间
mkdir my-codex-project
cd my-codex-project
codex常见问题
是的，两者使用不同的令牌组：
请在 ZetaRouter 平台创建对应的专用令牌。
配置文件放在哪里？
%USERPROFILE%\.codex\macOS/Linux:
~/.codex/
修 改于 2026-05-04 16:44:36