Codex 快速开始指南

前置条件：安装 Node.js 环境

Codex 依赖 Node.js 运行环境，请先参考Node.js 环境安装指南完成安装并验证。

1. 安装 Codex

验证安装：

输出版本号即表示安装成功。

2. 创建 API Key

填写密钥名称，选择Codex分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

3. 导入密钥到 Codex

推荐使用 CC Switch 工具进行一键配置，也可手动创建配置文件。

方式一：CC Switch（推荐）

前往 CC Switch Release 下载安装后，点击 导入到 CCS 完成一键导入：

导入后点击启用即可。

方式二：手动配置文件

创建配置目录

# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"

创建 `config.toml`

在 ~/.codex/（Windows 为 %USERPROFILE%\.codex\）目录下创建 config.toml：

model_provider = "anyroute"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.anyroute]
name = "anyroute"
base_url = "https://cc.anyroute.io"
wire_api = "responses"
requires_openai_auth = true

创建 `auth.json`

点击密钥旁的复制按钮获取 API Key：

在同一目录下创建 auth.json，将 YOUR_API_KEY 替换为你在控制台创建的密钥：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

4. 开始使用

进入任意项目目录，运行：

Codex 会自动分析当前目录的代码并提供智能编程辅助。更多用法请参考 OpenAI 官方文档。

常见问题（FAQ）

Q：运行 npm install -g 提示权限不足？
A：macOS / Linux 在命令前加 sudo；Windows 使用管理员权限运行 PowerShell。

Q：codex --version 提示命令不存在？
A：确认 npm 全局目录已加入系统 PATH，可运行 npm bin -g 查看路径并手动添加。

Q：连接失败或返回 401 错误？
A：检查 config.toml 中 base_url 是否为 https://dragoncode.codes，以及 auth.json 中的 API Key 是否正确且未过期。

Q：如何切换不同模型或倍率？
A：在 AnyRoute 控制台创建不同分组的密钥，更新 auth.json 中的 Key，或通过 CC Switch 在多个配置间快速切换。

Codex 快速开始指南

前置条件：安装 Node.js 环境#

1. 安装 Codex#

2. 创建 API Key#

3. 导入密钥到 Codex#

方式一：CC Switch（推荐）#

方式二：手动配置文件#

创建配置目录#

创建 config.toml#

创建 auth.json#

4. 开始使用#

常见问题（FAQ）#