跳到主要内容

接入 Codex

本文介绍如何配置 OpenAI Codex CLI，通过太行HUB提供的 API 服务调用不同类型的大语言模型。

由于Codex主要通过 Responses API 与模型交互，而不同模型对于 OpenAI API 协议支持情况不同。
目前主要分为：

类型API Endpoint适用模型
Responses API/v1/responses新一代大语言模型
Chat Completions API/v1/chat/completions大多数传统兼容模型

请根据您使用的模型类型选择对应配置，针对不同模型支持的端点类型，可在模型广场中查看模型API示例。

安装 Codex CLI​

macOS / Linux​

npm install -g @openai/codex

安装完成后检查：

codex --version

启动Codex：

codex

Windows​

使用 PowerShell：

npm install -g @openai/codex

启动Codex：

codex

配置端点及 API Key​

请提前准备：

项目值
Base URLhttps://api.taiha.cn/v1
API Key在控制台创建
Model ID在模型广场查看

设置环境变量​

macOS / Linux

执行：

export OPENAI_API_KEY="<API Key>"
备注

如果希望永久保存API KEY： 编辑：~/.zshrc
加入：export OPENAI_API_KEY="API Key"
然后：source ~/.zshrc

Windows PowerShell

执行：

setx OPENAI_API_KEY "<API Key>"

重新打开终端即可生效。

使用 Responses API 端点​

修改 Codex 配置文件

配置文件位置：

~/.codex/config.toml

添加以下代码：

model_provider = "taiha"

[model_providers.taiha]
name = "taiha"
base_url = "https://api.taiha.cn/v1"
wire_api = "responses"

model = "<Model ID>"

启动Codex：

codex

使用 Chat Completions API 端点​

针对于只支持/chat/completions端点的模型需要进行此项操作

配置：

model_provider = "taiha"

[model_providers.taiha]
name = "taiha"
base_url = "https://api.taiha.cn/v1"
wire_api = "chat"

model = "<Model ID>"

多模型切换配置​

如果您同时提供多种模型，可以创建多个 Provider。

model_provider = "responses-model"

[model_providers.responses-model]
name = "Responses Models"
base_url = "https://api.taiha.cn/v1"
wire_api = "responses"

model = "<Model ID>"

[model_providers.chat-model]
name = "Chat Models"
base_url = "https://api.taiha.cn/v1"
wire_api = "chat"

model = "<Model ID>"

切换模型：

codex --model <Model ID>

常见问题​

Q：模型请求时报错 404 /v1/chat/completions

当前模型只支持 Responses API。 修改配置为 wire_api = "responses"

Q：模型请求时报错 404 /v1/responses

当前模型只支持 Chat Completions。 修改配置为 wire_api = "chat"

Q：API Key 无效

检查：

echo $OPENAI_API_KEY

确认环境变量是否正确。

Q：如何确认请求协议？

POST /v1/responses