接入指南

Codex 客户端

用 CA 客户端一键接入 Codex Desktop,或手动写 ~/.codex/config.toml 并配置 OPENAI_API_KEY。

Codex 客户端(Codex Desktop)是 OpenAI 官方推出的桌面端 AI 编程助手。

方式一:CA 客户端一键接入(推荐)

CA 客户端 是 CA云上创造 的官方桌面客户端,可以傻瓜式完成 Codex 客户端的下载、免订阅 CA 接入、模型配置等流程,真正做到 5 分钟开箱即用,免去用户自己摸索和试错的烦恼。

  • ·【 下载 windows 版 】
  • ·【 下载 mac 版 】
TIP:下载安装过程中,如遇系统误报风险提示,请选择信任或继续。
  1. 1.安装完成后,如图所示,请完成账号注册。
  2. 2.进入客户端后,找到 Codex 客户端进行下载 & 安装(或自行从 OpenAI 官网下载)。
  3. 3.而后,点击“连接 CA”按钮,您会看到选择模型的弹窗,在此选择您需要接入的模型即可。如需在 Codex 中接入 Kimi K3 模型,在此选择后接入即可。
  4. 4.客户端会自动将您本机的 Codex 客户端与 CA云上创造 完成连接 & 配置。
  5. 5.若您需要切换回 OpenAI 官方订阅套餐,可点击“断开 CA”按钮,即可断开 Codex 客户端与 CA云上创造 的连接。
  6. 6.点击确认接入后,点击打开应用,就可以正常开始使用 Codex 了。
  7. 7.您可以在 CA云上创造 的控制台,看到每条请求的用量情况。

方式二:手动配置(不推荐)

如您不想使用 CA 客户端,也可参考本章手动进行 Codex 安装 & CA云上创造 接入。

手动下载 Codex

如果您已安装 Codex 客户端,可跳过本章。

根据你的系统选择对应的安装包下载:

  • ·macOS(Apple Silicon,M 系列芯片):Codex.dmg
  • ·macOS(Intel 芯片):Codex-latest-x64.dmg
  • ·Windows:Microsoft Store 安装

下载后双击安装包,按提示完成安装。Linux 用户暂时只能使用 CLI 版本(参考 CA云上创造 接入 Codex)。

修改系统配置文件

macOS / Linux 用户

打开终端,把下面整段粘进去回车:

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

Windows 用户

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

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

[model_providers.ca]
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 用户

powershell
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的-CA-key", "User")
Windows 用户:执行完上面命令后,关闭 Codex 桌面版重新打开一次才能读到新的环境变量。

启动 Codex 桌面版

打开 Codex 桌面版应用,如果之前已经打开过,请关闭后重新打开。

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