概览与选型

实践指南收录把常见编程 Agent、CLI、IDE 接到 ApiGo 统一网关的配置配方。你只需一把 sk-apigo-... Key，从模型目录选择模型 ID，即可在不同工具间切换，而无需为每家厂商单独申请密钥。

开始之前

在工作空间 → API Keys 创建 API 密钥，并妥善保存。
按客户端协议确认 Base URL（不要混用）：

协议	Base URL	常见客户端
OpenAI 兼容	`https://api.apigo.ai/v1`	Codex CLI、Cursor、DeepSeek Harness、Kimi Code、OpenCode、Hermes、OpenClaw（OpenAI 路径）
Anthropic Messages	`https://api.apigo.ai`	Claude Code、Claude Desktop、OpenClaw（Anthropic 路径）

完整复制模型目录展示的 slug，并与客户端协议匹配，例如：
- OpenAI 兼容路径：gpt-5.6-sol
- Anthropic Messages：claude-sonnet-5

先验证网关可用

在配置任何 Agent 之前，可用下面命令确认 Key 与网络正常：

export APIGO_API_KEY=sk-apigo-...

curl https://api.apigo.ai/v1/models \
  -H "Authorization: Bearer $APIGO_API_KEY"

再发一条最小对话：

curl https://api.apigo.ai/v1/chat/completions \
  -H "Authorization: Bearer $APIGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "ping"}]
  }'

成功后，到工作空间 → Call Logs 应能看到对应请求。

环境变量速查

变量	用途
`APIGO_API_KEY`	推荐统一存放的 ApiGo Key
`ANTHROPIC_BASE_URL`	Claude Code / Desktop 等 Anthropic 客户端的网关根地址
`ANTHROPIC_AUTH_TOKEN`	填 ApiGo Key；同时建议把 `ANTHROPIC_API_KEY` 显式置空
`OPENAI_BASE_URL` / `OPENAI_API_KEY`	部分 OpenAI 系工具使用；配置 ApiGo 前先清除旧值，避免串台

如何选择配方

你在用…	打开
终端里的 Claude	Claude Code
Claude 桌面端	Claude Desktop
OpenAI Codex 终端 Agent	Codex CLI
Cursor 编辑器	Cursor
DeepSeek 开源 Agent Harness	DeepSeek Harness
Nous Hermes	Hermes Agent
Kimi 终端编程 Agent	Kimi Code
多通道消息 Agent	OpenClaw
OpenCode TUI / 桌面端	OpenCode

编程 Agent 列表

指南	工具	协议
Claude Code	Anthropic 终端编程 Agent	Anthropic
Claude Desktop	Claude Desktop 第三方 Gateway	Anthropic
Codex CLI	OpenAI 本地编程 Agent	OpenAI
Cursor	Cursor BYOK / Base URL 覆盖	OpenAI
DeepSeek Harness	DeepSeek AI 开源 Agent Harness	OpenAI（自定义 provider）
Hermes Agent	Nous Research 终端 Agent	OpenAI（自定义端点）
Kimi Code	Moonshot AI 终端编程 Agent	OpenAI（Kimi provider）
OpenClaw	多通道 Agent 平台	OpenAI 或 Anthropic
OpenCode	开源 TUI / 桌面编程 Agent	OpenAI（自定义 provider）

为什么通过 ApiGo 接入

一把 Key：覆盖多家上游模型，按 slug 切换即可
可控成本：消费上限、RPM，以及路由策略的回退链
可观测：CLI、IDE、后端流量共享用量与调用日志

配置完成后，在 Agent 中发一条短提示，再到工作空间 → Call Logs 确认请求已到达。若 Call Logs 无记录，优先检查 Base URL 是否写对、Key 是否被旧环境变量覆盖。

下一步

完成快速开始（若尚未创建 Key）
按上表打开对应 Agent 配方
需要生产级可用性时，为该 Key 绑定路由策略

Claude Code