Skip to Content
接入 Agent 工具总览

接入 Agent 工具

以下配置按各工具当前官方契约编写。先选择工具,再使用对应协议和模型,不要在不同工具之间混用 Base URL 格式。

工具协议与接口
Claude CodeAnthropic Messages · POST /v1/messages
CodexOpenAI Responses · POST /v1/responses
OpenCodeOpenAI Compatible · POST /v1/chat/completions
OpenClawOpenAI Compatible · POST /v1/chat/completions
HermesOpenAI Compatible · POST /v1/chat/completions
WorkBuddyOpenAI Chat · POST /v1/chat/completions

优先通过环境变量或工具自带的凭据存储保存 API Key。不要把真实密钥写入项目配置、截图、聊天记录或 Git 仓库。

接入前检查

  1. 先调用 GET /v1/models,确认当前 API Key 可以看到教程中的模型。
  2. 严格区分三类地址:Claude Code 使用不带 /v1 的站点地址;Codex 和 OpenAI Compatible 工具使用带 /v1 的地址。
  3. 首次配置后先执行一个只读任务,例如“概述当前目录”,确认回复和工具调用都正常,再授权修改代码。

常见问题

  • 401:检查 API Key 是否有效,以及工具是否使用 Authorization: Bearer 发送凭据。
  • 404 或模型不存在:核对模型名大小写,并通过 GET /v1/models 确认可用性。
  • 能对话但不能操作文件:检查工具权限、工作目录和所选模型的工具调用能力。
  • 请求发往错误路径:重新检查本页表格中的协议,不要把 /v1/responses 配置给只支持 Chat Completions 的工具。
Last updated on