Agent 集成
每个应用的完整配置步骤都在这里。登录后自动填入你的密钥和可用模型,并核对真实请求。
ChatGPT
ChatGPT 桌面端 · Codex · Responses
官方文档 · Codex 配置参考使用端
支持
- 流式回复
- 函数调用(function call)
- Codex 本地工具,含 apply_patch 改文件
- 用量与费用记账
不支持 / 注意
- Responses 是无状态的:不支持存储会话、previous_response_id、后台模式
- 不支持 OpenAI 托管的联网检索与文件检索
- 只影响新建的本地任务,不改变 Codex 云端会话
- Base URL
- https://router-api.xiu.ai/v1
- 请求接口
- /v1/responses
- 模型
- 登录后只显示所选密钥当前可用的模型,并写入生成配置。
开始之前
先确认桌面端是最新版
打开 ChatGPT 桌面端,检查更新并装到最新版。旧版本可能没有自定义 provider 的配置入口。
下面的步骤用的是占位符:YOUR_XIUROUTER_API_KEY 换成你自己的密钥,YOUR_MODEL_ID 换成精确的模型 ID。登录后这两项会自动填好,复制时还会直接注入密钥。
1. 为 ChatGPT 保存密钥
把 YOUR_XIUROUTER_API_KEY 换成你的密钥。在控制台里复制会直接注入所选密钥,不用手改。
终端(写入当前用户环境) launchctl setenv XIUROUTER_API_KEY "YOUR_XIUROUTER_API_KEY"桌面端从 Dock 启动时读不到普通终端里的 export,所以这里写的是用户级环境变量。写完必须完全退出 ChatGPT 再重开。
2. 添加 XiuRouter provider
在桌面端里打开 Settings → Configuration → Open config.toml。把下面这段追加到文件末尾。已有的其他 provider 都保留,不要删。
~/.codex/config.toml model = "YOUR_MODEL_ID" model_provider = "xiurouter" [model_providers.xiurouter] name = "XiuRouter" base_url = "https://router-api.xiu.ai/v1" env_key = "XIUROUTER_API_KEY" wire_api = "responses"这一步只新增,不会删掉任何已有配置。
3. 重新打开并新建任务
完全退出 ChatGPT(不是关窗口),重新打开,然后在 Codex 里新建一个本地任务。已经开着的任务不会换 provider。
4. 新建任务并测一次
在新任务里发一句只读指令,例如「看一下这个项目用的什么框架,不要改文件」。
怎样算成功
Codex 正常回答,且控制台的「检查实际请求」里会出现一条接口为 /v1/responses、模型为你所选、状态成功的记录。
没成功怎么办
5登录后继续配置
控制台会填好你的密钥和它能调用的模型,并用一条真实请求核对,让你确认连接确实生效了。