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
模型
登录后只显示所选密钥当前可用的模型,并写入生成配置。

开始之前

  1. 先确认桌面端是最新版

    打开 ChatGPT 桌面端,检查更新并装到最新版。旧版本可能没有自定义 provider 的配置入口。

下面的步骤用的是占位符:YOUR_XIUROUTER_API_KEY 换成你自己的密钥,YOUR_MODEL_ID 换成精确的模型 ID。登录后这两项会自动填好,复制时还会直接注入密钥。

  1. 1. 为 ChatGPT 保存密钥

    把 YOUR_XIUROUTER_API_KEY 换成你的密钥。在控制台里复制会直接注入所选密钥,不用手改。

    终端(写入当前用户环境)
    launchctl setenv XIUROUTER_API_KEY "YOUR_XIUROUTER_API_KEY"

    桌面端从 Dock 启动时读不到普通终端里的 export,所以这里写的是用户级环境变量。写完必须完全退出 ChatGPT 再重开。

  2. 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. 3. 重新打开并新建任务

    完全退出 ChatGPT(不是关窗口),重新打开,然后在 Codex 里新建一个本地任务。已经开着的任务不会换 provider。

  4. 4. 新建任务并测一次

    在新任务里发一句只读指令,例如「看一下这个项目用的什么框架,不要改文件」。

怎样算成功

Codex 正常回答,且控制台的「检查实际请求」里会出现一条接口为 /v1/responses、模型为你所选、状态成功的记录。

没成功怎么办

5

登录后继续配置

控制台会填好你的密钥和它能调用的模型,并用一条真实请求核对,让你确认连接确实生效了。