Agent 与开发客户端
Codex、Claude Code、Cursor 接入 XiuRouter 时,先选对客户端协议
三类客户端的配置入口、请求协议和能力边界不同。这里负责选择路径;每个应用的完整配置、验证与恢复步骤继续以当前 Docs 为准。
从客户端出发,不从模型品牌猜协议
客户端决定请求格式和配置面;所选模型还必须声明对应端点,并落在 Key 的模型范围内。
- 适合
- 适合 Codex CLI、IDE 或桌面端中的本地 Codex 任务。
- 选择路径
- 选择 Responses,并为新建本地任务配置 XiuRouter provider;用一条只读小任务核对连接。
- 能力边界
- 只改变本地 Codex 请求,不改变云端 ChatGPT 会话;OpenAI 托管检索、存储会话和后台模式不在当前兼容范围。
- 适合
- 适合 Claude Code CLI、VS Code 扩展和当前桌面端 Code 模式。
- 选择路径
- 选择 Anthropic Messages,并使用不带重复 /v1 的网关根地址;完成一次本地任务后再判断接入成功。
- 能力边界
- 本地网关不会带来 Claude 云端环境、SSH、Remote Control 或 Anthropic 托管服务端工具。
- 适合
- 适合 Cursor 当前允许覆盖 OpenAI Base URL 的自定义模型路径。
- 选择路径
- 选择 Chat Completions,先验证 Ask 和请求记录;需要 Agent 改文件时,再单独验证模型的工具调用表现。
- 能力边界
- Base URL 覆盖是全局的;Cursor 专有模型与 Tab 补全仍走 Cursor 自己的服务,Agent 改文件能力也不能由兼容接口保证。
能回答,不等于整条 Agent 链路已验收
先验证客户端真正需要的最小行为,再核对对应请求证据。
- 1
确认客户端以所选模型命中预期协议路径。
- 2
对编程 Agent,测试一个有边界的工具或文件任务,而不只看文本回复。
- 3
在依赖这份配置前,从使用记录核对模型、档位、状态、Token 和结算。