接入指南

Codex 命令行

安装 Codex CLI,并通过 config.toml 的 Provider 配置与 API Key 接入 CA。

Codex 是 OpenAI 官方推出的运行在终端中的 AI 编程助手。先完成第一节安装,再按第二节接入 CA;已安装 Codex 的用户可直接从第二节开始。

一、安装 Codex

推荐安装 Node.js 22+(或使用 Homebrew / 官方 installer)。

macOS 用户也可以直接使用 Homebrew 安装:brew install codex

在命令行界面,执行以下命令安装 Codex:

bash
npm install -g @openai/codex

安装结束后,执行以下命令,若显示版本号则安装成功:

bash
codex --version

二、接入 CA

配置 Provider

macOS / Linux 用户:打开终端,把下面整段粘进去回车:

bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model_provider = "caapi"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.caapi]
name = "CA云上创造"
base_url = "https://caapi.top/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

Windows 用户:打开 PowerShell(开始菜单搜「PowerShell」),把下面整段粘进去回车:

bash
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "caapi"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.caapi]
name = "CA云上创造"
base_url = "https://caapi.top/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

设置 API Key

把下面命令里的 <你的-CA-key> 替换成你自己创建的 API Key,API Key 在 CA 控制台获取。然后粘到终端执行。

macOS 用户

bash
echo 'export OPENAI_API_KEY="<你的-CA-key>"' >> ~/.zshrc
source ~/.zshrc

Linux 用户

bash
echo 'export OPENAI_API_KEY="<你的-CA-key>"' >> ~/.bashrc
source ~/.bashrc

Windows 用户

bash
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<你的-CA-key>", "User")
Windows 用户:执行完上面命令后,关闭当前 PowerShell 窗口重新打开一次才能生效。

两步都做完后,在终端执行 codex 就会走 CA。

三、开启快速模式(可选)

快速模式(Fast mode)可以让 GPT 系列模型输出更快(gpt-5.6-sol 最高可达标准速度的 2.5 倍),按标准价 2 倍计费。

临时开启:在 Codex 会话内输入:

bash
/fast

/fast 是开关命令,再输入一次即关闭。)

长期开启:在 ~/.codex/config.toml 顶部加一行:

toml
service_tier = "fast"

之后该配置下的请求都会走快速模式。

50 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。