跳转到主要内容
推荐通过 CC Switch 导入。手动配置按以下步骤操作。

安装

安装 Node.js 和 npm 后运行:
系统要求与其他安装方式见 官方安装说明。

保存配置和模型目录

  1. 在控制台对应服务的 访问密钥 列表中,点击 使用 → 客户端配置,选择 Codex 和操作系统。
  2. 在 Codex 模型目录 中点击 获取目录,选择可用模型。
  3. 按窗口显示的路径保存生成的配置;已有文件先备份并合并。config.toml 的顶层字段放在任何 [表名] 之前,避免重复字段或表。
  4. 点击 下载目录,把 codex-models.json 保存到配置中 model_catalog_json 指向的位置。
默认配置目录为 ~/.codex/,Windows 为 %USERPROFILE%\.codex\。设置过 CODEX_HOME 时使用该目录,并同步修改 model_catalog_json;WSL 使用 WSL 用户目录。详见 官方配置说明。 不同密钥和认证模式生成的内容可能不同,按控制台显示保存文件或设置环境变量。若生成了 auth.json,但之前使用系统凭据存储,按 官方认证说明 在 config.toml 顶层设置:
地址以控制台为准,不要重复追加 /v1 或 /responses。可用模型变化后,重新获取并下载目录,替换本地文件。

验证

重启 codex,发送“只回答 OK”,在 仪表盘 的 调用记录 核对请求。请求失败见 常见问题。