接入工具

把你已经在用的编程工具接到 SwatowAPI，只需要做一件事：把工具里的 Base URL 和 API Key 指向 SwatowAPI，其余工作流保持不变。你不需要更换工具、也不需要改变使用习惯。

工具走哪一套协议接口（OpenAI / Anthropic / Google），取决于你调用时所用 Key 所属分组的平台。同一个域名会按 Key 的分组平台自动路由到对应的协议面。详见 认证与分组。

一览表

下表列出常见工具对应的 Base URL、环境变量与协议面。请用你在控制台签发的 Key（sk-...）替换示例。

工具	Base URL	环境变量 / 认证头	协议面
OpenAI 兼容工具（Cursor、Cline 等）	https://swato.ai/v1	OPENAI_BASE_URL / OPENAI_API_KEY	OpenAI
Claude Code	https://swato.ai	ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN	Anthropic
Codex	https://swato.ai/v1	见 Codex 接入	Responses API
Gemini CLI / Google SDK	https://swato.ai/v1beta	x-goog-api-key: sk-...	Google

TIP

不确定某个模型的准确 model 字符串时，调用 GET /v1/models 获取当前可用模型的确切 id，不要凭记忆填写。

各工具接入

Claude Code

设置两个环境变量，然后运行 claude：

export ANTHROPIC_BASE_URL="https://swato.ai"
export ANTHROPIC_AUTH_TOKEN="sk-your-swatowapi-key"
claude

客户端会在 ANTHROPIC_BASE_URL 之后自动补上 /v1/messages 请求路径。使用 Claude Code 需要你的 Key 属于 Anthropic 平台的分组。

Cursor

在 Cursor 的设置中启用自定义 OpenAI Base URL，把它填成 https://swato.ai/v1，粘贴你的 API Key，然后选择要用的模型。可用模型的确切 id 来自 GET /v1/models。

Cline / Roo Code

在提供商（Provider）里选择 "OpenAI Compatible"，Base URL 填 https://swato.ai/v1，API Key 填 sk-...，再选择你要用的模型即可。

Codex

Codex 走 Responses API，Base URL 为 https://swato.ai/v1。它有独立的详细配置说明，见 Codex 接入。

Gemini CLI / Google SDK

Gemini 系工具使用 Base https://swato.ai/v1beta，认证通过请求头 x-goog-api-key: sk-...（也可用 ?key= 查询参数），沿用 Gemini 自身的约定。使用 Gemini 接口需要你的 Key 属于 Google 平台的分组。

验证

配置完成后，用工具跑一个只读的小任务（例如让它总结一段代码，不做写盘），然后到控制台的用量账单里确认这次调用有记录：能看到对应的模型、输入/输出 token 和计费金额，就说明接入成功。失败或超时的请求不会计费。

相关文档

• 快速开始
• 认证与分组
• 计费与账单