API快连 apikl.ai
首页 控制台

Claude Code 安装与国内使用教程（2026）：Base URL、API Key 配置

更新于

这篇把 Claude Code 接入 API 快连要做的事一次讲全：安装、Base URL 和 API Key 怎么填、Windows / macOS / Linux 的设置方法、怎么长期生效、怎么验证，以及最常见的报错怎么排查。照着做，一般 5 分钟内就能用上，不需要 Claude 官方订阅。

📌
一句话答案：Base URL 填 https://apikl.ai（不要带 /v1），认证填控制台创建的 sk-... 密钥，变量名用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。
项目填写内容说明
Base URLhttps://apikl.ai站点根地址，Claude Code 会自己拼接 /v1/messages
API Keysk-...在 控制台 创建，创建时分组选 Claude 类分组
变量名ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN也可用 ANTHROPIC_API_KEY，二选一
测试模型claude-sonnet-5-5先用它测通，再按需要换 Opus

准备工作

  • Node.js 22 或更高版本（用 npm 安装时需要；用官方安装脚本可以不装）：终端运行 node -v 查看版本，还没装的看 Node.js 环境安装教程。
  • 一个 API 快连密钥：登录 控制台 新建密钥，分组选择 Claude 类分组（例如 Claude-Max）。密钥绑定在分组上，GPT 分组的密钥调不了 Claude 模型。
  • 一个终端：macOS 用「终端」，Windows 用 PowerShell，Linux 用任意终端。

第一步：安装 Claude Code

方式一：npm 安装（国内推荐）

BASH
npm install -g @anthropic-ai/claude-codeclaude --version

需要 Node.js 22 或更高版本。能输出版本号就说明装好了。国内下载 npm 包慢或失败时，可以先切换到国内镜像再安装：npm config set registry https://registry.npmmirror.com。

方式二：官方安装脚本（不需要 Node.js）

macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows · PowerShell
irm https://claude.ai/install.ps1 | iex

官方脚本会自动后台更新。脚本需要能访问 claude.ai，国内网络下载失败时请改用方式一。装好后可以运行 claude doctor 检查安装和配置是否正常。

💡
macOS / Linux 提示 EACCES 权限错误时，不建议直接加 sudo；用 nvm 等工具在用户目录安装 Node.js 后再装，后续升级也更省事。

第二步：弄清 Base URL 和两个变量

Claude Code Base URL 为什么不能带 /v1

Claude Code 走的是 Anthropic 协议，它会在 Base URL 后面自动拼上 /v1/messages 等路径。如果你填成 https://apikl.ai/v1，实际请求就变成 /v1/v1/messages，表现为 404、模型不存在或鉴权异常。所以 Claude Code 只填根地址 https://apikl.ai，末尾也不要加斜杠。

同一个站点给不同客户端填的地址不一样，最容易混淆的是 Claude Code 和 Codex：

客户端协议变量 / 字段应该填
Claude CodeAnthropicANTHROPIC_BASE_URLhttps://apikl.ai
Codex CLI / Codex 桌面版OpenAI 兼容config.toml 的 base_urlhttps://apikl.ai/v1
Cline / Roo Code / Cursor 等OpenAI 兼容Base URLhttps://apikl.ai/v1

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 选哪个

两个都能用，API 快连都认。推荐用 ANTHROPIC_AUTH_TOKEN：它不会触发首次启动的确认提示。用 ANTHROPIC_API_KEY 时，Claude Code 第一次启动会问「是否使用这个 API Key」，默认选项是 No，直接回车会被拒绝，然后跳去要求登录官方账号，很多人卡在这一步。

⚠️
两个变量只设置一个，不要同时设置，否则 Claude Code 可能提示认证冲突。

第三步：写入配置（三种方法任选一种）

方法一：settings.json（推荐，长期生效，三系统通用）

Claude Code 会读取用户目录下的 ~/.claude/settings.json（Windows 是 C:\Users\你的用户名\.claude\settings.json）。没有这个文件就新建一个，写入：

~/.claude/settings.json
{ "env": { "ANTHROPIC_BASE_URL": "https://apikl.ai", "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥" }}

如果文件里已经有其他内容，只把 env 这一段合并进去，不要整个覆盖。这种写法不依赖终端类型，VS Code、JetBrains 里的 Claude Code 插件也会读到同一份配置。

方法二：临时环境变量（只对当前终端窗口有效）

适合先试一下能不能用。关掉终端窗口后就失效了。

macOS / Linux
export ANTHROPIC_BASE_URL="https://apikl.ai"export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"claude
Windows · PowerShell
$env:ANTHROPIC_BASE_URL="https://apikl.ai"$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"claude
Windows · CMD
set ANTHROPIC_BASE_URL=https://apikl.aiset ANTHROPIC_AUTH_TOKEN=sk-你的密钥claude

方法三：写进 Shell 配置文件（长期生效）

macOS 默认用 zsh，写进 ~/.zshrc；Linux 多数是 bash，写进 ~/.bashrc：

macOS（zsh）
echo 'export ANTHROPIC_BASE_URL="https://apikl.ai"' >> ~/.zshrcecho 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrcsource ~/.zshrc
Windows · PowerShell（永久写入用户变量，新开终端生效）
setx ANTHROPIC_BASE_URL "https://apikl.ai"setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
🔒
密钥等同于密码：不要发到群里、截图里或提交到公开代码仓库。泄露后去控制台删除旧密钥、重新创建即可。

第四步：验证是否接通

新开一个终端窗口（让变量生效），运行：

BASH
claude --model claude-sonnet-5-5

进入交互界面后发一句「你好，用一句话介绍你自己」，能正常回复就说明接通了。在 Claude Code 里输入 /status 可以查看当前生效的连接和认证信息。

如果 Claude Code 连不上，想判断是密钥问题还是客户端配置问题，可以绕开 Claude Code 直接请求一次接口（macOS / Linux，需要先按方法二在当前终端设置好变量）：

BASH · 直接测试接口
curl https://apikl.ai/v1/messages \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"你好"}]}'

返回一段 JSON 且里面有回复内容，说明密钥和网络都没问题，剩下的就是 Claude Code 本身的配置问题；返回 401 说明密钥不对；返回 404 或 model not found 看下面的报错排查。

怎么选模型、怎么切换

  • 日常写代码：claude-sonnet-5-5，速度快、单价低，绝大多数任务够用。
  • 复杂任务：claude-opus-5-5 或 claude-opus-5，适合大型重构、疑难排查、长链路规划，单价更高。
  • 切换方法：启动时加 --model 模型名；会话中输入 /model 切换；想固定默认模型，在 settings.json 里加一行 "model": "claude-sonnet-5-5"。

各模型实时价格看 模型广场。用量记录里偶尔出现 claude-haiku-4-5 之类你没选过的模型，是 Claude Code 自己在后台用小模型做辅助判断，属于正常现象。

国内怎么用：代理和中转说明

这里说的「中转」是 API 接入层：Claude Code 把请求发到 API 快连，由 API 快连转给上游模型。所以：

  • 不需要 Claude 官方账号或 Pro / Max 订阅，按实际用量扣费，先充少量余额试用即可。
  • 国内多数网络可以直接访问 apikl.ai，一般不需要额外开代理。
  • 默认地址 https://apikl.ai 之外，还有备用线路 https://api.apikl.ai（以前的默认地址，已经配好的不用改）和一条不经过 CDN 的直连线路 https://dc.apikl.ai，网络不稳定或长任务超时时可以换用，Claude Code 同样填根地址、不带 /v1。
  • 如果你电脑上开着代理软件并设置了 HTTPS_PROXY 等变量，出现连接超时可以先关掉代理或取消这些变量再试，排除本地网络干扰。
i
生产环境建议在控制台给密钥设置额度上限，并做好失败重试；不要把同一个密钥分给太多人同时用，并发过高时容易触发限流。

常见报错与解决办法

401 / invalid api key / 认证失败

  • 密钥没复制完整，或前后多了空格、引号。从 sk- 开始完整复制。
  • 变量没生效：改完要新开终端。macOS / Linux 可以用 echo $ANTHROPIC_BASE_URL 检查。
  • 密钥在控制台被删除或禁用了，重新创建一个。
  • 更多情况看 401 invalid_api_key 怎么解决。

启动后还是要求登录官方账号

说明 Claude Code 没读到你的配置。最常见的原因是用了 ANTHROPIC_API_KEY、首次启动询问时选了 No。改用 ANTHROPIC_AUTH_TOKEN（方法一最省事），重新打开终端再启动即可。

404 / model not found / model not exist

  • Base URL 多写了 /v1 或其他路径，改回 https://apikl.ai。
  • 模型名拼错，比如 claude-sonnet-5.5 应为 claude-sonnet-5-5（用短横线）。
  • 密钥所在分组不是 Claude 分组，换一个 Claude 分组的密钥。
  • 详细排查看 model not exist 怎么解决。

403 insufficient balance / 余额不足

余额用完了，充值后即可恢复。另外，同时开很多个 Claude Code 窗口并发请求时，系统会为每个进行中的请求预留一部分额度，余额较低时可能还没扣完就提示余额不足，充值或减少同时运行的会话即可。

429 / 503 / Overloaded（繁忙或限流）

上游模型繁忙或短时限流，Claude Code 会自动重试，一般等几秒就恢复。长时间持续出现，可以先换一个模型继续工作，或联系客服。

配置改了却不生效

检查是不是在多个地方设置了不同的值：系统环境变量、~/.zshrc、settings.json 各写了一份，旧值可能覆盖新值。建议只保留一处（推荐 settings.json），改完新开终端。

省钱小技巧

  • Claude Code 默认使用提示缓存：同一个会话里连续对话时，前面的上下文大多按更便宜的缓存价计费。
  • 缓存几分钟没用就会过期。长时间离开后再回到一个很长的会话，会按全价重新计算一遍上下文，单次费用会明显偏高。
  • 换新任务时用 /clear 开新会话；会话太长时用 /compact 压缩上下文。这两个习惯能明显降低费用。
  • 简单任务用 Sonnet，复杂任务再切 Opus。

常见问题

Claude Code 国内能用吗？

能。按本文把 Base URL 指向 API 快连即可，国内多数网络可以直接访问，不需要海外账号或信用卡。

需要 Claude Pro / Max 订阅吗？

不需要。通过 API 快连使用是按实际用量计费，不用订阅，也不用登录 Anthropic 官方账号。

Base URL 填 apikl.ai 还是 apikl.ai？

填 https://apikl.ai。apikl.ai 是网站和控制台，不是接口地址。

Claude Code 和 Codex 能用同一个密钥吗？

一般不能。密钥绑定在分组上：Claude 分组的密钥调 Claude 模型，GPT 分组的密钥调 GPT 模型。两个都用就各建一个密钥。

想用图形界面管理配置可以吗？

可以。用 CC Switch 一键导入 API 快连的配置，还能在官方和多个服务商之间切换。

✅
还没有密钥？去控制台创建 →  ·  看模型价格 →  ·  同时用 Codex？看 Codex 配置教程