Agent 工具总览​

yuyuflow 的模型接口可以接入多种 Agent 和编程助手。推荐先完成快速开始和 LLM 配置，确认账号、额度、API Key、模型名与接口协议，再按使用场景选择客户端。

接入路径​

Agent 工具的接入通常分为三层：

  1. 平台 API：在控制台创建凭证，并确认目标模型和额度可用。
  2. 兼容协议：根据客户端要求选择 OpenAI Chat Completions、OpenAI Responses 或 Claude 兼容接口。
  3. Agent 客户端：在客户端配置文件或配置管理工具中填写地址、凭证和模型，然后重启客户端验证。

先确认接口协议

不同工具使用的协议并不相同。Codex 页面使用 Responses API；WorkBuddy / CodeBuddy 的自定义模型配置使用 OpenAI 兼容的 Chat Completions；Claude Code 使用 Claude 兼容接口；OpenCode、OpenClaw、Hermes 和 Reasonix 的底层协议或自定义 endpoint 以各自客户端版本的 provider/setup 向导为准。不要直接复制另一种工具的 URL、配置文件或鉴权变量。

工具选择​

工具定位接口协议配置方式文档
CC-Switch统一管理多个 CLI provider由目标工具决定图形化 provider 配置CC-Switch 配置
Codex终端中的编码 AgentResponses APIconfig.toml + auth.jsonCodex 配置
Claude CodeClaude 兼容的编码 AgentClaude 兼容接口.claude/settings.jsonClaude Code 配置
OpenCode终端中的开源编码 Agent以 provider 向导和当前版本为准/connect provider 配置OpenCode 配置
OpenClaw终端 Agent 与自动化工具以 onboarding 向导和当前版本为准openclaw onboardOpenClaw 配置
Hermes终端和开发工作流 Agent以 setup 向导和当前版本为准hermes setupHermes 配置
Reasonix项目编码 Agent参考页面未公开完整协议setup wizard，配置保存于 ~/.reasonix/config.jsonReasonix 配置
WorkBuddy / CodeBuddy桌面端 Agent 与编程助手OpenAI Chat Completions.codebuddy/models.jsonWorkBuddy / CodeBuddy 配置

推荐配置顺序​

  1. 阅读快速开始，完成账号、额度和凭证准备。
  2. 阅读 LLM 配置，确认 Base URL、模型 ID、令牌分组和通用请求方式。
  3. 如果需要在多个客户端之间切换，先配置 CC-Switch。
  4. 根据工具选择 Codex、Claude Code、OpenCode、OpenClaw、Hermes、Reasonix 或 WorkBuddy / CodeBuddy 的专属配置。
  5. 先用客户端要求的最小请求验证，再开始执行代码或其他 Agent 任务。

协议与地址对照​

客户端配置中的地址形态需要注意
Codex平台 Base URL，配合 wire_api = "responses"必须确认平台和模型支持 Responses API
WorkBuddy / CodeBuddyhttps://art-api.yuyuflow.com/v1/chat/completions使用 Chat Completions 请求格式；Base URL 已带 /v1 时不要重复拼接
Claude Code平台提供的 Claude 兼容 Base URL按客户端要求设置 ANTHROPIC_AUTH_TOKEN 和模型变量
OpenCode通过 /connect provider 向导配置DeepSeek 参考页面未公开底层配置文件和 endpoint
OpenClaw通过 onboarding provider 向导配置具体协议和 endpoint 以客户端版本为准
Hermeshttps://art-api.yuyuflow.com（setup 向导要求时填写）参考页面未公开完整 endpoint 和配置文件 schema
Reasonixart-api.yuyuflow.com 或客户端向导要求的地址直接连接 API host；完整协议和 endpoint 以客户端为准

如果遇到 401、404 或协议错误，请先回到快速开始的排查清单，再检查对应工具页面中的常见问题。

凭证安全​

  • 不要把真实 API Key 写入 Git、项目共享配置、截图、日志或聊天记录。
  • 示例中的 YOUR_API_KEY、${API_KEY} 和 YOUR_MODEL 都是占位符。
  • 项目级配置提交前应加入 .gitignore；生产环境优先使用环境变量或密钥管理服务。
  • 为开发、测试和生产环境分别创建凭证，便于权限控制和成本排查。