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 --versionWindows 用户建议在 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-idCodex 会按你选择的权限模式,在修改文件或执行命令前请求确认。
设置自定义 model_provider 后,所有请求都会发往 AI 星图,并按 AI 星图的价格从余额扣费。价格见 模型广场。
常见问题
- 报错提示模型不可用或不支持该接口:该模型不支持
/v1/responses,到 模型广场 换一个支持该接口的模型。 - 报 401:检查
env_key对应的环境变量是否已在当前终端生效,Key 是否正确。
更多排查方法见 错误排查。
本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。