CodeX 部署指南

企业级 AI 编码助手 — 完整部署手册。

� 前置要求

请先完成 Node.js 环境安装 和 CC-Switch 工具安装。

🚀 使用 CC-Switch 快速配置（推荐）

配置步骤

1. 启动 CC-Switch 并切换到 Codex 标签
   • 打开 CC-Switch 应用程序
   • 点击顶部的「Codex」标签页
   • 点击右上角橙色「+」按钮添加新配置
2. 填写 CodeX 提供商配置
   • 提供商名称：自定义名称（如 my-proxy）
   • Base URL：https://api.nassaapi.xyz
   • API Key：粘贴您的专属 Key（务必确保令牌额度充足或设为无限）
   • Model：选择 gpt-5.4（本站当前主推 GPT-5 系列，具体可选型号见 模型列表）
   • 其他配置：根据需求调整推理强度、网络访问等参数
   • 点击「保存」按钮
3. 启用配置并使用
   • 在配置列表中找到刚创建的配置
   • 点击配置右侧的「当前使用」按钮
   • 重启 CodeX，新配置即可生效
4. 系统托盘快速切换
   • 右键点击系统托盘中的 CC-Switch 图标
   • 在菜单中选择 Codex 分类
   • 直接选择要切换到的配置，立即生效

💡 提示

• CC-Switch 会自动创建 ~/.codex/config.toml 和 auth.json 文件
• 可以添加多个提供商配置，随时切换
• 切换配置后，关闭并重启 CodeX 即可生效

⚠️ 注意事项

• 务必从本站创建有效的 API 密钥
• CodeX 令牌与 Claude Code 令牌不通用
• 切换配置后需要重启 CodeX 才能生效

⌨️ 手动命令行配置

🖥️ Windows 平台

第一步：部署 CodeX 命令行工具

以管理员权限启动命令提示符或 PowerShell，执行：

npm install -g @openai/codex@latest
codex --version

第二步：集成 API 服务

构建配置目录：

mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex

编写配置文件：config.toml

model_provider = "my-proxy"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true

[model_providers.my-proxy]
name = "my-proxy"
base_url = "https://api.nassaapi.xyz"
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 = "my-proxy"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
approval_policy = "on-request"
sandbox_mode = "danger-full-access"
model_supports_reasoning_summaries = true

[model_providers.my-proxy]
name = "my-proxy"
base_url = "https://api.nassaapi.xyz"
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 平台

步骤与 macOS 完全一致，参考上方 macOS 平台即可（所有路径、命令通用）。

常见问题

CodeX 和 Claude Code 的令牌不通用？

是的。请在控制台 → 令牌管理中，为 CodeX 单独创建一个令牌，选择包含 Codex 模型的令牌组。

配置文件放在哪里？

• macOS / Linux：~/.codex/config.toml 与 ~/.codex/auth.json
• Windows：%USERPROFILE%\.codex\config.toml 与 auth.json

更多问题

请查阅 疑难杂症 或 常见问题 (FAQ)。