开发文档 · 专业接入指南
一个 zk_ 密钥即可调用 8 个主流模型,跨 OpenAI、Anthropic、Google 三家。完全兼容 OpenAI 与 Anthropic 两套接口, 可直接驱动 Claude Code、Continue 等终端 AI 工具, 支持 agent 自主调用工具、读写编辑文件 的完整专业工作流——把 base_url 指向凯洛、用你的凯洛密钥即可,无需改动业务代码。
1 · 获取密钥
试用密钥以 zk_ 开头,直接使用即可。也可登录 控制台 · API 密钥 查看或新建。请妥善保管、勿外泄,每次调用按 token 实时计费。
2 · 两个接入端点(按工具选其一)
Base URL : https://kailoo.ai/v1 鉴权 : Authorization: Bearer zk_你的密钥
Base URL : https://kailoo.ai 鉴权 : x-api-key: zk_你的密钥 (Claude Code 用环境变量,见下)
OpenAI 系工具走 /v1/chat/completions, Anthropic 系(含 Claude Code)走 /v1/messages。 两套端点的所有模型都支持 流式输出 与 工具调用(function calling / tool use)。
3 · ⭐ Claude Code(旗舰专业用法 · agent / 改文件)
一键安装(裸机可用 · 自动装 Node + VS Code + Git + Claude Code + 配置 + 验证)
就算是啥都没装的新电脑也能跑通:自动安装 Node、VS Code、Git,再装 Claude Code、写好环境变量、实跑验证密钥,并配好 联网搜索。运行中按提示粘贴你的 zk_ 密钥即可。
🟢 最简单(推荐 · 不用懂命令行)
下载下面这个文件,直接双击运行,按提示粘贴 zk_ 密钥即可,全程不用自己开 PowerShell。
下载一键安装器(kailoo-install.bat · 双击运行)技术用户 · 也可在 PowerShell 里一行(运行,不是阅读):
irm https://kailoo.ai/install/kailoo-claude-code-setup.ps1 -OutFile $env:TEMP/kailoo.ps1; & $env:TEMP/kailoo.ps1
或下载离线运行 —— Windows:powershell -ExecutionPolicy Bypass -File .\kailoo-claude-code-setup.ps1;macOS / Linux:bash kailoo-claude-code-setup.sh。
VSCode 用户:装完要完全重启 VSCode(关掉整个窗口再开,光重开终端不生效),新终端里才能用 claude。
💡 联网搜索:开箱即用。Claude Code 内置 WebSearch 经凯洛 原生可用,无需额外安装、无需 Python——配好凯洛接入即可直接联网搜索(与官方一致)。
也可手动配置:凯洛兼容 Anthropic 原生接口,可直接作为 Claude Code 的后端。设置好环境变量后照常运行 claude, agent 自主决策、运行 skill、读写与编辑文件等能力全部可用:
export ANTHROPIC_BASE_URL=https://kailoo.ai export ANTHROPIC_AUTH_TOKEN=zk_你的密钥 # 注意:用 AUTH_TOKEN,不是 API_KEY export ANTHROPIC_MODEL=claude-opus-4-7 # 可选 · 切换默认模型 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001 # 必填 · Claude Code 后台小模型 claude
$env:ANTHROPIC_BASE_URL = "https://kailoo.ai" $env:ANTHROPIC_AUTH_TOKEN = "zk_你的密钥" # 注意:用 AUTH_TOKEN,不是 API_KEY $env:ANTHROPIC_MODEL = "claude-opus-4-7" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5-20251001" # 必填 · 后台小模型 claude
接第三方中转必须用 ANTHROPIC_AUTH_TOKEN(密钥经 Authorization: Bearer 发送)。若误用 ANTHROPIC_API_KEY,Claude Code 会按官方账号校验密钥导致鉴权失败(401)。
ANTHROPIC_DEFAULT_HAIKU_MODEL 也要设:Claude Code 后台任务(会话标题、索引等)会单独调一个小模型,默认指向官方 haiku,凯洛不提供该 id,不设会在运行时报错。 指向 claude-haiku-4-5-20251001 即可。老版本 Claude Code 用旧名 ANTHROPIC_SMALL_FAST_MODEL。
切换模型:改 ANTHROPIC_MODEL 为 claude-sonnet-4-6 或 claude-haiku-4-5-20251001,或在会话内用 /model 命令。重度 agent 任务建议 opus-4-7 或 sonnet-4-6。
+ · 更多命令行工具(同一密钥 · 同 kailoo 反代)
下面这些工具都用同一个 zk_ 密钥、走同一个 kailoo 反代。各自一键脚本会装好并配好,运行中粘贴密钥即可。
OpenAI Codex CLI
OpenAI 官方终端 agent。一键脚本自动装 Node + Codex,写好 ~/.codex/config.toml 的 kailoo provider(模型 gpt-5.5),设好密钥并验证。
下载一键安装器(kailoo-codex.bat · 双击运行)irm https://kailoo.ai/install/kailoo-codex-setup.ps1 -OutFile $env:TEMP/kx.ps1; & $env:TEMP/kx.ps1
OpenClaw beta
开源通用 AI 助手(连微信 / Telegram / Slack 等)。脚本把它的模型后端指向 kailoo(~/.openclaw/openclaw.json),OpenClaw 本体请先按 官方文档 装好。
irm https://kailoo.ai/install/kailoo-openclaw-setup.ps1 -OutFile $env:TEMP/kc.ps1; & $env:TEMP/kc.ps1配置脚本 (.ps1)
+ · 推荐 Skill / Agent(Claude Code 插件 · 走 marketplace 装)
这些是 Claude Code 插件,装了在客户端跑、模型调用照样过 kailoo。在 Claude Code 里跑下面命令加 marketplace,再 /plugin 里挑着装。
Superpowers · 工作流套件
一次 add 就有一整套:规划 brainstorm、系统化调试、TDD、代码评审、写实施计划。个人开发者最值的一个包。
/plugin marketplace add obra/superpowers-marketplace
Anthropic 官方插件
Anthropic 官方出品的插件集合,最安全省心。
/plugin marketplace add anthropics/claude-plugins-official
加完 marketplace,在 Claude Code 里输 /plugin 浏览并安装想要的 skill / agent。
4 · Continue(VS Code / JetBrains)
编辑 ~/.continue/config.yaml, provider 用 openai,apiBase 必须带 /v1:
models:
- name: Kailoo Opus 4.7
provider: openai
model: claude-opus-4-7
apiBase: https://kailoo.ai/v1
apiKey: zk_你的密钥
roles: [chat, edit, apply]
- name: Kailoo GPT-5.5
provider: openai
model: gpt-5.5
apiBase: https://kailoo.ai/v1
apiKey: zk_你的密钥
roles: [chat, edit, apply]其它兼容 OpenAI / Anthropic 的工具(Cursor、aider、Cline 等)同理:把 base_url 指向凯洛、模型名用下方清单即可。
5 · 工具调用 / 改文件(agent 核心能力)
凯洛完整透传 tool use。模型会自主决定调用你定义的工具(如写文件),返回结构化的调用参数——这是 agent 自动改文件的底层机制:
curl https://kailoo.ai/v1/messages \
-H "x-api-key: zk_你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-7",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "把 hello.txt 内容改成 hi there"}
],
"tools": [{
"name": "write_file",
"description": "Write content to a file",
"input_schema": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}]
}'
# 返回 stop_reason=tool_use,含 write_file 的 path 与 content6 · Python · OpenAI SDK
from openai import OpenAI
client = OpenAI(api_key="zk_你的密钥", base_url="https://kailoo.ai/v1")
resp = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "你好"}],
stream=True, # 流式
)
for chunk in resp:
delta = chunk.choices[0].delta.content or ""
print(delta, end="", flush=True)7 · Python · Anthropic SDK
from anthropic import Anthropic
client = Anthropic(api_key="zk_你的密钥", base_url="https://kailoo.ai")
msg = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)8 · Node · OpenAI SDK
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "zk_你的密钥",
baseURL: "https://kailoo.ai/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.4",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);9 · 可用模型 · 随时切换
只需把请求里的 model 字段换成下列任一名称,无需改其它代码:
# OpenAI 系(/v1/chat/completions) gpt-5.5 # reasoning 模型 · 重任务首选 · maxTokens 勿设太小 gpt-5.4 gpt-5.4-mini # 最省 · 适合高频轻量 # Anthropic 系(/v1/messages 或 /v1/chat/completions 均可) claude-opus-4-7 # 全横杠无点 · 重度 agent 首选 claude-sonnet-4-6 claude-haiku-4-5-20251001 # Google 系 gemini-2.5-flash gemini-2.5-pro # reasoning 模型 · max_tokens 勿设太小
注意大小写与连接符:gpt-5.5 用点,claude-opus-4-7 全横杠无点。试用密钥仅放行以上模型,填写其它名称返回 403。
10 · 在线 Playground(快速试)
想快速验证密钥与模型,打开 Playground,粘贴 zk_ 密钥、选模型、按 Enter 发送即可对话(Shift+Enter 换行)。 网页对话用于轻量测试;agent、skill、批量改文件等专业工作流,请用上面的 Claude Code / Continue 等终端工具。