Claude Code 怎么接入 KL API
Claude Code 通过 ANTHROPIC_BASE_URL(不带 /v1)和 AUTH_TOKEN 接入 KL API。(2026-11-22)
适用系统:Windows / macOS / Linux · 更新于
准备工作
- 已安装 Node.js 18 或以上,`npm -v` 能跑起来
- 一个 KL API 的 API Key(在控制台创建)
- 已安装 Claude Code(`npm install -g @anthropic-ai/claude-code`)
配置项对照
| 配置项 | 应填值 |
|---|---|
ANTHROPIC_BASE_URL |
https://agent.kl-api.info —— 不要带 /v1 |
ANTHROPIC_AUTH_TOKEN |
你的 API Key |
| 模型 | claude-sonnet-4-6(或 模型清单 里其他 Claude 模型) |
注意
base_url 多写一层 /v1 不会报配置错误,只会让请求打到 /v1/v1/messages,表现为 404。这是这份教程里最容易错的一处。
设置环境变量
export ANTHROPIC_BASE_URL="https://agent.kl-api.info"
export ANTHROPIC_AUTH_TOKEN="你的 Key"
setx ANTHROPIC_BASE_URL "https://agent.kl-api.info"
setx ANTHROPIC_AUTH_TOKEN "你的 Key"
macOS / Linux 想让每次开终端都生效,把两行写进 ~/.zshrc 或 ~/.bashrc,然后 source 一次。Windows 用 setx 之后要重开终端。
提示
也有教程用 ANTHROPIC_API_KEY。走第三方接口时建议只用 ANTHROPIC_AUTH_TOKEN:两个变量同时设置时,客户端会同时发两个头(Authorization: Bearer <AUTH_TOKEN> 和 x-api-key: <API_KEY>),服务端认哪个不由客户端决定,排查时很难分辨。只设一个最省事。
验证
先看变量是否真的进了当前终端,再启动一次会话:
echo "$ANTHROPIC_BASE_URL" && claude -p "只回复 OK 两个字"
$env:ANTHROPIC_BASE_URL; claude -p "只回复 OK 两个字"
看到 OK 就是通了。打印出来是空串说明变量没生效——先解决这一步,别急着查 Key。
常见端口与路径对应
| 你填的 base_url | 实际请求(含查询串) | 结果 |
|---|---|---|
https://agent.kl-api.info |
POST /v1/messages?beta=true |
正确 |
https://agent.kl-api.info/v1 |
POST /v1/v1/messages |
404,原文 Invalid URL (POST /v1/v1/messages) |
(路径取自 2026-11-22 对 claude-cli 2.1.280 的抓包实测,查询串 ?beta=true 是客户端自动附加的。)
换模型
在同一会话里用 /model 切换,或启动时带参数指定。模型清单见 模型清单,价格见 价格与计费。
验证状态
| 项目 | 状态 |
|---|---|
不带 /v1 时打到 /v1/messages |
已实测(2026-11-22,claude-cli 2.1.280,Windows) |
带 /v1 时打到 /v1/v1/messages 并返回 404 |
已实测,404 原文为 Invalid URL (POST /v1/v1/messages) |
| 两个变量同时设会同时发两个头 | 已实测 |
| 用真 Key 端到端跑通 | 未验证 |
Windows setx + 重开终端 |
未验证 |
| macOS / Linux 全流程 | 未验证 |
未验证项会在用真 Key 跑通后更新本表,不提前标成「已验证」。
参考来源(核对于 2026-11-22)
- Anthropic 协议 base_url 不带
/v1:Anthropic Python SDK 源码中默认值为https://api.anthropic.com(https://github.com/anthropics/anthropic-sdk-python/blob/main/src/anthropic/_client.py) - 接口地址与鉴权方式:快速开始
- 报错原文与分层排查:API 报 401、429、超时怎么排查