开发文档 · 专业接入指南

一个 zk_ 密钥即可调用 8 个主流模型,跨 OpenAI、Anthropic、Google 三家。完全兼容 OpenAI 与 Anthropic 两套接口, 可直接驱动 Claude Code、Continue 等终端 AI 工具, 支持 agent 自主调用工具、读写编辑文件 的完整专业工作流——把 base_url 指向凯洛、用你的凯洛密钥即可,无需改动业务代码。

1 · 获取密钥

试用密钥以 zk_ 开头,直接使用即可。也可登录 控制台 · API 密钥 查看或新建。请妥善保管、勿外泄,每次调用按 token 实时计费。

2 · 两个接入端点(按工具选其一)

OpenAI 兼容 · 大多数工具与 SDK
Base URL : https://kailoo.ai/v1
鉴权     : Authorization: Bearer zk_你的密钥
Anthropic 原生 · Claude Code / Anthropic SDK
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、读写与编辑文件等能力全部可用:

macOS / Linux
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
Windows PowerShell
$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

~/.continue/config.yaml
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 · Anthropic /v1/messages · tool use
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 与 content

6 · Python · OpenAI SDK

pip install openai
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

pip install anthropic
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

npm i openai
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 等终端工具。