Codex、Claude Code 等工具接入
先选使用端和操作系统，再按步骤配置。进入 XiuRouter 控制台后，可选择密钥和可用模型，并核对真实请求。
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
- 模型
- 进入 XiuRouter 控制台的「Agent 集成」，选择密钥和它能调用的模型。
开始之前
还没安装 ChatGPT？
已经安装就跳过这一项。还没安装时，复制下面的地址，粘贴到浏览器地址栏并打开，按官方说明下载和安装对应系统的桌面端。安装后先不要在登录框里填 XiuRouter 密钥，继续下面的配置步骤。
浏览器地址栏 https://chatgpt.com/download/先确认使用端和密钥
本教程用于 ChatGPT 桌面端里的本地 Codex 任务。点击站点导航的“控制面板”（手机先展开菜单），登录 XiuRouter 后进入“Agent 集成”，选择可用密钥和模型。已在控制台时直接完成选择。ChatGPT 登录页的“OpenAI API 密钥”用于官方服务；XiuRouter 要先在应用外配置，不用把密钥填进那个登录框。
打开用来执行命令的窗口
按 Command + 空格，输入“终端”，按 Return 打开。下面的命令都粘贴到这个窗口，按 Return 执行。
公开页展示占位符示例：YOUR_XIUROUTER_API_KEY 换成你的密钥，YOUR_MODEL_ID 换成完整模型 ID。在 XiuRouter 控制台选择密钥和模型后，配置会自动填好；复制密钥命令时会注入所选密钥。
1. 完全退出 ChatGPT
点击屏幕左上角 ChatGPT → 退出 ChatGPT，或按 Command + Q。只关窗口不算退出。
2. 备份并打开配置文件
回到命令窗口，复制下面整段并执行。它会创建所需文件夹和配置文件，给现有配置做一份带时间的备份，再用文本编辑器打开文件。不会覆盖原有配置。
macOS 终端 mkdir -p "$HOME/.codex" touch "$HOME/.codex/config.toml" cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.backup-$(date +%Y%m%d-%H%M%S)" open -e "$HOME/.codex/config.toml"打开的文件是 ~/.codex/config.toml。备份也在同一文件夹，文件名以 config.toml.backup- 开头。
3. 设置模型和服务
在刚打开的文件中，把下面三行放到文件最上面，位于任何以 [ 开头的配置段之前。已有 model、model_provider 或 web_search 时，只改原来的值，不要再粘贴一份；其它设置保留。
~/.codex/config.toml · 文件顶部 model = "YOUR_MODEL_ID" model_provider = "xiurouter" web_search = "disabled"YOUR_MODEL_ID 要换成完整模型 ID；在 XiuRouter 控制台选择模型后，本页会自动填好。web_search 关闭 OpenAI 托管检索，避免首次测试调用不支持的工具。
4. 添加 XiuRouter 配置并保存
把下面整段放到文件末尾。若已有 [model_providers.xiurouter]，替换这一段及它的 xiurouter.auth 子段（如有），不要重复添加。其它 provider 保留。
~/.codex/config.toml · 文件末尾 [model_providers.xiurouter] name = "XiuRouter" base_url = "https://router-api.xiu.ai/v1" env_key = "XIUROUTER_API_KEY" wire_api = "responses"在 TextEdit 中按 Command + S 保存，然后关闭文件。若看到富文本格式，先选择“格式 → 制作纯文本”；文件名保持 config.toml。
5. 保存 XiuRouter 密钥
回到刚才的命令窗口，复制下面整段并执行。在 XiuRouter 控制台点复制会自动填入所选密钥；公开页的 YOUR_XIUROUTER_API_KEY 要换成自己的密钥。
macOS 终端 launchctl setenv XIUROUTER_API_KEY "YOUR_XIUROUTER_API_KEY"没有输出、回到命令提示符就是执行完成。这条命令在当前登录期间有效；注销或重启电脑后，需重新执行本步再打开 ChatGPT。
6. 重新打开 ChatGPT
从“应用程序”或 Dock 重新打开 ChatGPT。首次使用会进入新手引导；完成引导后切到 Codex。已有任务保持原连接，要新建本地任务。
7. 新建本地任务并验证
在 Codex 中打开一个本地文件夹，新建任务，把下面的测试消息粘贴到输入框并发送。收到回复后，回到 XiuRouter 控制台 → Agent 集成 → 检查实际请求，点击“刷新记录”。模型要与本页所选一致，接口要是 /v1/responses，状态要是成功。
新建本地 Codex 任务的输入框 告诉我当前文件夹的名称，不要修改文件。只看到 ChatGPT 打开不代表接入成功，以 XiuRouter 实际请求记录为准。
怎样算成功
Codex 正常回答，且控制台的「检查实际请求」里会出现一条接口为 /v1/responses、模型为你所选、状态成功的记录。
没成功怎么办
8登录后继续配置
控制台会填好你的密钥和它能调用的模型，并用一条真实请求核对，让你确认连接确实生效了。