OpenAI Codex CLI 接入 code0 API

本教程带你从零完成 Codex CLI 安装，并重点讲解如何通过 code0 API
网关接入，打造稳定的本地 AI 编程环境。

一、认识 Codex CLI

Codex CLI 是 OpenAI 官方开源的本地编码代理，基于 Rust 构建，
可在终端中直接读取代码上下文、修改文件、执行命令。

支持两种认证方式：

方式	适合场景
ChatGPT 账号登录	普通用户，消耗订阅额度
API Key 登录	开发者、CI/CD 集成、自定义网关接入

接入 code0 使用第二种方式，按量计费，灵活可控。

二、安装 Codex CLI

Node.js 环境（推荐）

macOS（Homebrew）

Windows 用户建议在 WSL 中安装，原生 Windows 支持目前仍处于实验阶段。

三、获取 code0 API Key

访问 code0.ai 注册并登录

进入控制台 → API 密钥 → 创建新密钥

复制以 sk- 开头的密钥，妥善保存（只显示一次）

四、配置 code0 网关

Codex 的核心配置文件位于 ~/.codex/config.toml，
CLI 和 IDE 扩展共用这套配置。

以下提供两种配置方案：

方案 A：极简模式（快速上手）

直接覆盖默认 Base URL，适合只需要快速跑通的场景。

~/.codex/config.toml

model = "gpt-5.1"
model_provider = "openai"

openai_base_url = "https://api.code0.ai/v1"

密钥写入 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-你的code0密钥"
}

或通过环境变量注入：

方案 B：专业模式（推荐）

新建独立 Provider 节点，配置更清晰，多服务商之间可秒级切换。

~/.codex/config.toml

model = "gpt-5.1"
model_provider = "code0"

[model_providers.code0]
name = "code0 API"
base_url = "https://api.code0.ai/v1"
wire_api = "responses"
env_key = "CODE0_API_KEY"
env_key_instructions = "启动前请先设置环境变量 CODE0_API_KEY"

设置环境变量后启动：

推荐使用方案 B。独立的 Provider 节点让配置文件语义更清晰，
也方便后续切换不同模型或服务商。

五、验证配置

启动后发送一条测试指令：

如果模型正常返回分析结果，说明配置成功 ✅

六、常用启动方式

七、Windows 特殊配置

原生 Windows 环境建议在 config.toml 中开启提权沙箱模式，
提升文件操作稳定性：

[windows]
sandbox = "elevated"

八、常见问题 FAQ

Q：提示 codex: command not found？

npm 全局安装的 bin 目录未加入 PATH。运行 npm config get prefix 查找路径，手动添加到系统环境变量。

Q：自定义 API 配置后请求报错？

按顺序检查：

config.toml 路径是否正确（~/.codex/config.toml）

base_url 末尾不要带斜杠

环境变量名与 env_key 字段是否完全一致

网关是否兼容 OpenAI responses 协议格式

Q：API Key 登录和 ChatGPT 登录有什么区别？

ChatGPT 登录消耗网页版订阅额度；API Key 登录走 Platform 计费体系，两者额度和账单完全独立。通过 code0 接入使用 API Key 方式，按实际用量付费，更适合开发者。

Q：如何切换不同模型？

修改 config.toml 中的 model 字段即可：

model = "gpt-5.1"      # gpt-5.1
model = "gpt-5.2"      # gpt-5.2
model = "gpt-5.4"      # gpt-5.4

重启 codex 后生效。

总结

步骤	操作
1	安装 Codex CLI（npm / Homebrew）
2	获取 code0 API Key
3	写入 `~/.codex/config.toml`（推荐方案 B）
4	设置环境变量 `CODE0_API_KEY`
5	运行 `codex` 验证配置

通过 code0 接入 Codex CLI，国内开发者可以获得稳定的 API 连接，
配合方案 B 的 Provider 配置，后续扩展和切换模型也极为便捷。

OpenAI Codex CLI 接入 code0 API

一、认识 Codex CLI#

二、安装 Codex CLI#

Node.js 环境（推荐）#

macOS（Homebrew）#

三、获取 code0 API Key#

四、配置 code0 网关#

方案 A：极简模式（快速上手）#

方案 B：专业模式（推荐）#

五、验证配置#

六、常用启动方式#

七、Windows 特殊配置#

八、常见问题 FAQ#

总结#