Agent 与开发客户端

Codex、Claude Code、Cursor 接入 XiuRouter 时,先选对客户端协议

三类客户端的配置入口、请求协议和能力边界不同。这里负责选择路径;每个应用的完整配置、验证与恢复步骤继续以当前 Docs 为准。

从客户端出发,不从模型品牌猜协议

客户端决定请求格式和配置面;所选模型还必须声明对应端点,并落在 Key 的模型范围内。

01

Codex

Responses

打开当前文档
适合
适合 Codex CLI、IDE 或桌面端中的本地 Codex 任务。
选择路径
选择 Responses,并为新建本地任务配置 XiuRouter provider;用一条只读小任务核对连接。
能力边界
只改变本地 Codex 请求,不改变云端 ChatGPT 会话;OpenAI 托管检索、存储会话和后台模式不在当前兼容范围。
02

Claude Code

Anthropic Messages

打开当前文档
适合
适合 Claude Code CLI、VS Code 扩展和当前桌面端 Code 模式。
选择路径
选择 Anthropic Messages,并使用不带重复 /v1 的网关根地址;完成一次本地任务后再判断接入成功。
能力边界
本地网关不会带来 Claude 云端环境、SSH、Remote Control 或 Anthropic 托管服务端工具。
03

Cursor

Chat Completions

打开当前文档
适合
适合 Cursor 当前允许覆盖 OpenAI Base URL 的自定义模型路径。
选择路径
选择 Chat Completions,先验证 Ask 和请求记录;需要 Agent 改文件时,再单独验证模型的工具调用表现。
能力边界
Base URL 覆盖是全局的;Cursor 专有模型与 Tab 补全仍走 Cursor 自己的服务,Agent 改文件能力也不能由兼容接口保证。

能回答,不等于整条 Agent 链路已验收

先验证客户端真正需要的最小行为,再核对对应请求证据。

  1. 1

    确认客户端以所选模型命中预期协议路径。

  2. 2

    对编程 Agent,测试一个有边界的工具或文件任务,而不只看文本回复。

  3. 3

    在依赖这份配置前,从使用记录核对模型、档位、状态、Token 和结算。