工具接入
Codex
用 AIPUT 的 Responses 格式接口配置 Codex 命令行。
模型调用暂未开放
本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。
需要哪种接口
OpenAI Responses。Codex 的自定义服务商只支持这一种格式，请在模型广场的「端点类型」里选择 Response，从列出的模型中选择。
只支持普通对话格式的模型，不能直接用于 Codex。需要时可以借助 CC Switch 的本地路由转换格式，具体以 CC Switch 官方说明为准。
开始之前
- 完成实名认证，认证通过后重新登录一次。
- 在主站「API 密钥」页面创建一把 Key，复制并妥善保存。
- 在模型广场的「端点类型」筛选里选择 Response（窄屏时点“筛选”按钮），从列出的模型中复制模型 ID。
另外需要先安装好 Codex，安装方法见 Codex 官方文档。
配置步骤
写入配置文件
打开 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），没有就新建，写入下面第一个标签里的内容。model 和 model_provider 两行必须放在文件最前面、所有 [...] 段落之前，否则不会生效；[model_providers.aiput] 这一段可以放在文件末尾。文件里原来已有这两行时，替换它们，不要重复写。
设置 Key
Key 不写进配置文件，而是放在环境变量 AIPUT_API_KEY 里，见第二、三个标签。临时设置只对当前终端窗口有效；想长期生效，把这一行加进终端的启动配置（例如 ~/.zshrc），Windows 可以在系统的"环境变量"设置里添加。
config.toml · 配置示例
model = "MODEL_ID_FROM_CATALOG"
model_provider = "aiput"
[model_providers.aiput]
name = "AIPUT"
base_url = "https://api.aiput.top/v1"
env_key = "AIPUT_API_KEY"
wire_api = "responses"终端 · 设置 Key
export AIPUT_API_KEY='YOUR_API_KEY'PowerShell · 设置 Key
$env:AIPUT_API_KEY = "YOUR_API_KEY"各项的含义：
model_provider = "aiput"：使用下面定义的 AIPUT 服务商。服务商名称不能用openai、ollama、lmstudio，这几个是 Codex 保留的。base_url：AIPUT 的地址，带/v1。env_key：存放 Key 的环境变量名。wire_api = "responses"：使用 Responses 格式。这是 Codex 目前唯一支持的写法。
怎样确认配置成功
在已经设置好 AIPUT_API_KEY 的终端里运行 codex，发一句简短的问题，能收到回复就说明配置成功。
也可以先单独测试接口。这会产生一次很小的调用费用：
终端 · 接口测试
curl -sS 'https://api.aiput.top/v1/responses' \
--header "Authorization: Bearer $AIPUT_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"MODEL_ID_FROM_CATALOG","input":"你好"}'Codex 自身的限制
- 部分功能（例如独立的联网搜索）对自定义服务商默认关闭，以 Codex 官方说明为准。
- 使用 AIPUT 时，Codex 不使用 ChatGPT 账号的额度，费用按 AIPUT 的价格计算。
常见问题
| 现象 | 处理 |
|---|---|
启动时报 wire_api 相关错误 | 确认写的是 wire_api = "responses" |
401 或"未提供令牌" | 当前终端没有设置 AIPUT_API_KEY，或设置在了另一个窗口 |
404，提示 Invalid URL | base_url 只写到 /v1，不要多写路径 |
| 提示无法解析返回内容 | base_url 少写了 /v1 |
404，提示 not found | 这个模型不支持 Responses 格式，换一个模型广场里标有 Response 的模型 |
| "无可用渠道" | 账户还没有实名认证、模型 ID 写错，或模型当前不可用，见常见问题 |
本页按 2026 年 10 月的 Codex 版本编写，界面和配置项可能随版本变化，以 Codex 官方说明为准。Codex 的名称和商标归其所有者所有，这里只表示兼容。