Codex 使用 Responses 协议。选择支持该协议和工具调用的文本模型分组,在密钥使用说明中获取匹配配置。

安装

安装 Node.js 后,在终端运行:

设置密钥

在同一终端启动 Codex,或将变量保存在操作系统的用户环境变量中,再重新启动终端。

配置服务商

编辑用户配置文件。macOS / Linux 为 ~/.codex/config.toml,Windows 为 %USERPROFILE%\.codex\config.toml。设置过 CODEX_HOME 时,编辑该目录下的 config.toml。 将 YOUR_MODEL_ID 替换成当前 Key 可用的模型 ID,把以下字段合并到已有文件中。顶层的 model_provider 和 model 放在第一个方括号表头之前。
env_key 填环境变量名称,密钥值放在 VC_API_KEY 中。此配置通过 API Key 和 HTTP 流式接口连接 VC。

开始使用

进入项目目录,运行 codex。选择信任的项目目录后,发送「读取 README 并总结项目用途,不修改文件」。可在会话中使用 /status 查看当前模型。

常见问题

  • 缺少 VC_API_KEY:在启动 Codex 的同一终端设置变量。
  • 404:base_url 到 /v1 为止,不要追加 /responses。
  • 模型不可用:从模型目录复制准确 ID,核对分组的 Responses 支持。
  • 修改后未生效:检查 CODEX_HOME、命令行参数和所选配置档案,重新启动会话。
完整配置项见 Codex 官方配置参考。