Codex 客户端(Codex Desktop)是 OpenAI 官方推出的桌面端 AI 编程助手。
方式一:CA 客户端一键接入(推荐)
CA 客户端 是 CA云上创造 的官方桌面客户端,可以傻瓜式完成 Codex 客户端的下载、免订阅 CA 接入、模型配置等流程,真正做到 5 分钟开箱即用,免去用户自己摸索和试错的烦恼。
- ·【 下载 windows 版 】
- ·【 下载 mac 版 】
TIP:下载安装过程中,如遇系统误报风险提示,请选择信任或继续。
- 1.安装完成后,如图所示,请完成账号注册。
- 2.进入客户端后,找到 Codex 客户端进行下载 & 安装(或自行从 OpenAI 官网下载)。
- 3.而后,点击“连接 CA”按钮,您会看到选择模型的弹窗,在此选择您需要接入的模型即可。如需在 Codex 中接入 Kimi K3 模型,在此选择后接入即可。
- 4.客户端会自动将您本机的 Codex 客户端与 CA云上创造 完成连接 & 配置。
- 5.若您需要切换回 OpenAI 官方订阅套餐,可点击“断开 CA”按钮,即可断开 Codex 客户端与 CA云上创造 的连接。
- 6.点击确认接入后,点击打开应用,就可以正常开始使用 Codex 了。
- 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"
EOFWindows 用户
打开 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 ~/.zshrcLinux 用户
bash
echo 'export OPENAI_API_KEY="你的-CA-key"' >> ~/.bashrc
source ~/.bashrcWindows 用户
powershell
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的-CA-key", "User")Windows 用户:执行完上面命令后,关闭 Codex 桌面版重新打开一次才能读到新的环境变量。
启动 Codex 桌面版
打开 Codex 桌面版应用,如果之前已经打开过,请关闭后重新打开。