Codex CLI

把 OpenAI 的终端编码代理 Codex CLI 指向 AI 星图,通过 Responses 接口调用模型。

Codex CLI 是 OpenAI 推出的、在本地终端运行的编码代理,能编辑代码、生成补丁并运行命令。它使用 OpenAI 兼容(Responses API)格式,也就是 POST /v1/responses,所以接入 AI 星图时只能选择支持 Responses 接口 的模型。

选择支持 Responses 接口的模型

不是每个模型都支持 /v1/responses。在 模型广场 选择一个支持 /v1/responses 的模型,使用它的模型 ID;不支持该接口的模型无法在 Codex CLI 中使用。走 Claude 原生 Messages 接口的终端工具见 Claude Code。Codex CLI 客户端本身未在 AI 星图环境逐一实机验证,配置项按其官方文档整理。

安装

先安装 Node.js(建议 LTS 版),再全局安装:

npm install -g @openai/codex
codex --version

Windows 用户建议在 WSL2 里使用(wsl --install,装完重启后在 WSL 里安装 Node.js 和 Codex CLI)。

配置

先把 Key 放进环境变量:

export MYAIEXP_API_KEY="sk-xxxxxxxx"

想长期生效,把这一行写进 ~/.zshrc 或 ~/.bashrc。

然后编辑 ~/.codex/config.toml(不存在就新建):

model = "your-model-id"  # 替换为模型广场中支持 /v1/responses 的模型 ID
model_provider = "myaiexp"

[model_providers.myaiexp]
name = "myaiexp"
base_url = "https://ai.myaiexp.com/v1"
env_key = "MYAIEXP_API_KEY"
wire_api = "responses"

要点:

  • base_url 带 /v1,Codex 会自己拼上 /responses。
  • wire_api = "responses" 表示使用 Responses 格式。
  • env_key 是存放 Key 的环境变量名,要和上一步 export 的变量名一致。
  • model 填模型广场中支持 /v1/responses 的模型 ID;模型名要和 GET /v1/models 完全一致,完整列表见 模型广场。

使用

cd /path/to/your/project
codex

启动后可以输入 /model 查看或切换模型(只切换到支持 /v1/responses 的模型)。也可以在启动时临时指定:

codex --model your-model-id

Codex 会按你选择的权限模式,在修改文件或执行命令前请求确认。

设置自定义 model_provider 后,所有请求都会发往 AI 星图,并按 AI 星图的价格从余额扣费。价格见 模型广场。

常见问题

  • 报错提示模型不可用或不支持该接口:该模型不支持 /v1/responses,到 模型广场 换一个支持该接口的模型。
  • 报 401:检查 env_key 对应的环境变量是否已在当前终端生效,Key 是否正确。

更多排查方法见 错误排查。

本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。

本页目录