接入 Agent 工具
以下配置按各工具当前官方契约编写。先选择工具,再使用对应协议和模型,不要在不同工具之间混用 Base URL 格式。
| 工具 | 协议与接口 |
|---|---|
| Claude Code | Anthropic Messages · POST /v1/messages |
| Codex | OpenAI Responses · POST /v1/responses |
| OpenCode | OpenAI Compatible · POST /v1/chat/completions |
| OpenClaw | OpenAI Compatible · POST /v1/chat/completions |
| Hermes | OpenAI Compatible · POST /v1/chat/completions |
| WorkBuddy | OpenAI Chat · POST /v1/chat/completions |
优先通过环境变量或工具自带的凭据存储保存 API Key。不要把真实密钥写入项目配置、截图、聊天记录或 Git 仓库。
接入前检查
- 先调用
GET /v1/models,确认当前 API Key 可以看到教程中的模型。 - 严格区分三类地址:Claude Code 使用不带
/v1的站点地址;Codex 和 OpenAI Compatible 工具使用带/v1的地址。 - 首次配置后先执行一个只读任务,例如“概述当前目录”,确认回复和工具调用都正常,再授权修改代码。
常见问题
401:检查 API Key 是否有效,以及工具是否使用Authorization: Bearer发送凭据。404或模型不存在:核对模型名大小写,并通过GET /v1/models确认可用性。- 能对话但不能操作文件:检查工具权限、工作目录和所选模型的工具调用能力。
- 请求发往错误路径:重新检查本页表格中的协议,不要把
/v1/responses配置给只支持 Chat Completions 的工具。
Last updated on