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。这是这份教程里最容易错的一处。

设置环境变量

macOS / Linux
export ANTHROPIC_BASE_URL="https://agent.kl-api.info"
export ANTHROPIC_AUTH_TOKEN="你的 Key"
Windows PowerShell
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>),服务端认哪个不由客户端决定,排查时很难分辨。只设一个最省事。

验证

先看变量是否真的进了当前终端,再启动一次会话:

macOS / Linux
echo "$ANTHROPIC_BASE_URL" && claude -p "只回复 OK 两个字"
Windows PowerShell
$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)

常见问题

Claude Code 配完还在连官方地址,为什么?

两个变量缺一不可:只设了 Key 没设 ANTHROPIC_BASE_URL,它仍会走默认官方地址。先 echo $ANTHROPIC_BASE_URL 确认当前终端真的读到了值,再重启会话。

为什么 base_url 不能带 /v1?

Claude Code 走 Anthropic Messages 协议,SDK 自己会拼 /v1/messages。base_url 再带一层就变成 /v1/v1/messages,直接 404。

提示 401 lab token denied 怎么办?

Key 没被接受。依次查:环境变量名是不是 ANTHROPIC_AUTH_TOKEN、Key 是否被禁用、账户是否欠费。详见 报错排查。

模型名填什么?

填 模型清单 里的 Claude 模型 ID,例如 claude-sonnet-4-6。带日期后缀的旧版本号可能不存在,会返回 404。