Codex CLI + code0 完整配置教程（Windows）

适用场景：通过 code0 使用 Codex CLI，一个 Key 调用全量主流模型
环境：Windows 10/11
最后更新：2026 年 4 月

📋 目录

准备工作

安装 Node.js

1. 准备工作

你需要准备：

✅ 一台 Windows 电脑

✅ code0 账号（注册地址）

✅ 充值后在后台获取的 API Key（格式 sk-xxxxxxxxxxxx）

code0 支持 OpenAI Responses API（/v1/responses 端点），兼容最新版 Codex CLI。

2. 安装 Node.js

Codex CLI 基于 Node.js，必须先安装。

访问 https://nodejs.org/，下载 LTS 版本

双击安装，一路 Next，确保勾选 Add to PATH

打开命令提示符或 PowerShell 验证：

node --version
npm --version

出现版本号即安装成功。

3. 安装 Codex CLI

npm install -g @openai/codex@latest

验证：

codex --version

4. 配置 API Key

方法一：临时设置（仅当前窗口生效）

PowerShell：

$env:OPENAI_API_KEY = "sk-你的code0密钥"

命令提示符（cmd）：

set OPENAI_API_KEY=sk-你的code0密钥

方法二：永久设置（推荐）⭐

PowerShell：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的code0密钥", "User")

设置后关闭并重新打开窗口，验证：

echo $env:OPENAI_API_KEY

输出你的 Key 即成功。

5. 配置 code0 网关

5.1 创建配置文件

# 创建目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

# 打开配置文件
notepad $env:USERPROFILE\.codex\config.toml

5.2 填入以下内容

model = "gpt-5.1"
model_provider = "custom"

[model_providers.custom]
name = "code0"
base_url = "https://hk.code0.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

保存并关闭。

参数说明

参数	说明
`model`	code0 支持的模型 ID，如 `gpt-5.1`、`gpt-4o`、`claude-sonnet-4-6` 等
`base_url`	code0 API 地址，必须带 `/v1`
`env_key`	读取 API Key 的环境变量名
`wire_api`	新版 Codex 必须填 `responses`

6. 验证配置

6.1 测试 code0 连通性

先确认网络能访问 code0：

ping hk.code0.ai

然后测试 API 请求：

curl.exe -X POST "https://hk.code0.ai/v1/chat/completions" `
  -H "Authorization: Bearer $env:OPENAI_API_KEY" `
  -H "Content-Type: application/json" `
  -d '{"model":"gpt-5.1","messages":[{"role":"user","content":"hello"}]}'

看到 AI 回复 = code0 连通正常 ✅

6.2 启动 Codex

codex

出现交互界面后输入 hello，看到回复即配置成功 🎉

7. 开始使用

基本操作

# 进入你的项目目录（重要！不要在 System32 下使用）
cd C:\Users\你的用户名\项目目录

# 启动 Codex
codex

快捷操作

操作	快捷键
发送消息	`Enter`
换行	`Ctrl+J`
退出	`Ctrl+C`
查看帮助	`/help`
清空对话	`/clear`
切换模型	`/model`

code0 支持的常用模型

通过 /model 可切换，常用的有：

模型	适合场景
`gpt-5.1`	OpenAI 主力模型
`gpt-4o`	性价比之选
`claude-sonnet-4-6`	Claude 日常开发首选
`claude-opus-4-7`	Claude 最强推理

完整模型列表以 code0 后台为准。

8. 常见问题

❌ `404 Not Found: Invalid URL (GET /v1/responses)`

原因： code0 的 /v1/responses 端点暂未适配，或 base_url 填错了。

解决：

确认 base_url 填的是 https://hk.code0.ai/v1

确认 wire_api = "responses"

如果仍然 404，联系 code0 客服确认端点支持情况

❌ `401 Unauthorized: Invalid token`

原因： API Key 无效或未生效。

解决：

# 检查 Key 是否设置成功
echo $env:OPENAI_API_KEY

# 如果为空，重新设置并重启窗口
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的code0密钥", "User")

❌ `expected value at line 2 column 21`

原因： config.toml 格式错误，通常是从网页复制时引号变成了中文引号。

解决： 在 notepad 里手动重新输入配置内容，确保所有引号都是英文半角 "。

❌ `不知道这样的主机 (os error 11001)`

原因： DNS 无法解析 code0 域名。

解决：

# 测试 DNS
ping hk.code0.ai

# 如果失败，尝试换 DNS
# 网络设置 → DNS 改为 8.8.8.8 或 114.114.114.114

❌ Sandbox 选择

首次启动会提示选择 sandbox 模式：

选项	说明
1. Set up default sandbox	推荐，需要管理员权限运行
2. Use non-admin sandbox	如果 default 后网络不通，试这个
3. Quit	退出

如果选 1 后出现网络不通（无法访问 code0），退出后重新启动选 2。

❌ `node 不是内部或外部命令`

原因： Node.js 未安装或未加入 PATH。

解决： 重新安装 Node.js，安装时勾选 Add to PATH，安装完重启终端。

💰 成本提示

Codex 每次对话消耗 token（输入 + 输出都计费）

对话越长、上下文越多，消耗越大

用 /clear 清空对话可以重置上下文，节省 token

code0 固定汇率 1.5 元 = 1 美元额度，价格透明

在 code0 后台可实时查看用量和消费明细

遇到问题？联系 code0 客服，提供报错截图和 request id 即可快速排查。

Codex 接入（CLI ）

Codex CLI + code0 完整配置教程（Windows）#

📋 目录#

1. 准备工作#

2. 安装 Node.js#

3. 安装 Codex CLI#

4. 配置 API Key#

方法一：临时设置（仅当前窗口生效）#

方法二：永久设置（推荐）⭐#

5. 配置 code0 网关#

5.1 创建配置文件#

5.2 填入以下内容#

参数说明#

6. 验证配置#

6.1 测试 code0 连通性#

6.2 启动 Codex#

7. 开始使用#

基本操作#

快捷操作#

code0 支持的常用模型#

8. 常见问题#

❌ 404 Not Found: Invalid URL (GET /v1/responses)#

❌ 401 Unauthorized: Invalid token#

❌ expected value at line 2 column 21#

❌ 不知道这样的主机 (os error 11001)#

❌ Sandbox 选择#

❌ node 不是内部或外部命令#

💰 成本提示#

Codex CLI + code0 完整配置教程（Windows）

📋 目录

1. 准备工作

2. 安装 Node.js

3. 安装 Codex CLI

4. 配置 API Key

方法一：临时设置（仅当前窗口生效）

方法二：永久设置（推荐）⭐

5. 配置 code0 网关

5.1 创建配置文件

5.2 填入以下内容

参数说明

6. 验证配置

6.1 测试 code0 连通性

6.2 启动 Codex

7. 开始使用

基本操作

快捷操作

code0 支持的常用模型

8. 常见问题

❌ `404 Not Found: Invalid URL (GET /v1/responses)`

❌ `401 Unauthorized: Invalid token`

❌ `expected value at line 2 column 21`

❌ `不知道这样的主机 (os error 11001)`

❌ Sandbox 选择

❌ `node 不是内部或外部命令`

💰 成本提示