OneinAI

Appearance

CodeX 部署指南 ​

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

资源地址
官方文档developers.openai.com/codex
oneinai 控制台https://api.oneinai.com/console/token

📋 前置要求 请先完成 Node.js 环境安装 和 CC-Switch 工具安装。

🎯 快速导航 ​

CodeX 是基于 GPT-5 架构的智能编程助手，为开发者提供卓越的代码生成与优化能力。

部署路径：系统环境配置 ➜ CLI 工具安装 ➜ API 集成 ➜ 开发环境就绪

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

⚠️ 前置条件 使用 CC-Switch 配置 CodeX 之前，请确保已通过 npm 全局安装 CodeX 工具：

bash
npm install -g @openai/codex@latest

验证安装：codex --version

推荐使用 CC-Switch 快速配置工具 进行图形化配置，简单快捷无需命令行操作。

配置步骤 ​

1. 启动 CC-Switch 并切换到 Codex 标签

  1. 打开 CC-Switch 应用程序
  2. 点击顶部的「Codex」标签页
  3. 点击右上角橙色「+」按钮添加新配置 g CC-Switch Codex 标签页

2. 填写 CodeX 提供商配置

配置项说明
提供商名称自定义名称，如「oneinai」
Base URLhttps://api.oneinai.com/v1
API Key在 oneinai 控制台 创建的 CodeX 专用令牌（codex 令牌组）
Modelgpt-5.4（撰写文档时最新模型为 5.4）
其他配置根据需求调整推理强度、网络访问等参数

填写完成后点击「保存」按钮。

CC-Switch 添加 CodeX 配置CC-Switch CodeX 配置详情

💡 提示

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

3. 启用配置并使用

  1. 在配置列表中找到刚创建的「oneinai」配置
  2. 点击配置右侧的「当前使用」按钮
  3. 配置会被标记为「当前使用」状态（绿色标签）
  4. 重启 CodeX，新配置即可生效

4. 系统托盘快速切换

CC-Switch 支持通过系统托盘快速切换 CodeX 配置：

  • 右键点击系统托盘中的 CC-Switch 图标
  • 在菜单中选择 Codex 分类
  • 直接选择要切换到的配置
  • 配置立即生效，无需打开主界面

⚠️ 注意事项

  • 务必在 oneinai 平台创建「codex」令牌组的专用密钥
  • CodeX 令牌与 Claude Code 令牌不通用
  • 切换配置后需要重启 CodeX 才能生效
  • 可在 CC-Switch 中测试 API 端点速度

⌨️ 手动命令行配置 ​

如果你不使用 CC-Switch，可以按照以下步骤手动配置 CodeX。

🖥️ Windows 平台 ​

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

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

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

第二步：集成 oneinai API 服务 ​

获取专属 API 凭证：

  1. 访问 oneinai 控制台
  2. 完成账户注册或登录
  3. 进入「API 密钥管理」模块
  4. 创建新密钥时务必选择「codex」令牌组
  5. 安全保存生成的 API Key

🔐 安全提醒 CodeX 要求使用独立的令牌组配置，与 Claude Code 令牌体系完全隔离。

构建配置目录结构：

powershell
mkdir $env:USERPROFILE\.codex
cd $env:USERPROFILE\.codex

编写配置文件 config.toml：

toml
model_provider = "oneinai"
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.oneinai]
name = "oneinai"
base_url = "https://api.oneinai.com/v1"
wire_api = "responses"
requires_openai_auth = true

编写认证文件 auth.json：

json
{
  "OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
}

第三步：初始化工作空间 ​

powershell
mkdir my-codex-project
cd my-codex-project
codex

🍏 macOS 平台 ​

部署 CodeX 工具 ​

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

集成 API 服务 ​

构建配置目录：

bash
mkdir -p ~/.codex
cd ~/.codex

编写 config.toml 配置：

bash
cat > config.toml << 'EOF'
model_provider = "oneinai"
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.oneinai]
name = "oneinai"
base_url = "https://api.oneinai.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

编写 auth.json 认证配置：

bash
cat > auth.json << 'EOF'
{
  "OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
}
EOF

初始化工作空间 ​

bash
mkdir my-codex-project
cd my-codex-project
codex

🐧 Linux 平台 ​

部署 CodeX 工具 ​

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

集成 API 服务 ​

构建配置目录：

bash
mkdir -p ~/.codex
cd ~/.codex

编写 config.toml 配置：

bash
cat > config.toml << 'EOF'
model_provider = "oneinai"
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.oneinai]
name = "oneinai"
base_url = "https://api.oneinai.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

编写 auth.json 认证配置：

bash
cat > auth.json << 'EOF'
{
  "OPENAI_API_KEY": "此处粘贴你的 CodeX 专用令牌"
}
EOF

初始化工作空间 ​

bash
mkdir my-codex-project
cd my-codex-project
codex

❓ 常见问题 ​

CodeX 和 Claude Code 的令牌不通用？ ​

是的，两者使用不同的令牌组：

  • Claude Code：使用 Claude Code 令牌组
  • CodeX：使用 codex 令牌组

请在 oneinai 平台创建对应的专用令牌。

配置文件放在哪里？ ​

  • Windows：%USERPROFILE%\.codex\
  • macOS / Linux：~/.codex/

更多问题 ​

请查看 FAQ 或联系售后支持。