Skip to content

Claude Code 接入自定义 API ​

Claude Code 通过两个环境变量决定请求发到哪里、用什么密钥:

环境变量填写内容
ANTHROPIC_BASE_URLhttps://api.niceai.dev(不要加 /v1)
ANTHROPIC_AUTH_TOKEN你的 NiceAI API 密钥

如果你已经装了 CC Switch,可以直接用 CC Switch 一键导入,不用手动改配置。下面是手动配置的方法。

准备工作 ​

  1. 安装 Claude Code(参考其官方文档)。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组选择 Claude。

方式一:写进 settings.json(推荐) ​

编辑用户级配置文件,没有就新建:

  • macOS / Linux:~/.claude/settings.json
  • Windows:%USERPROFILE%\.claude\settings.json
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.niceai.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

保存后重新打开终端,运行 claude 即可。这种方式对所有终端生效,也不会被其他项目的环境变量覆盖。

TIP

如果 settings.json 里已经有其他配置,只需把 env 中的两项合并进去,注意 JSON 的逗号。

方式二:设置环境变量 ​

bash
# 临时生效(只对当前终端)
export ANTHROPIC_BASE_URL="https://api.niceai.dev"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

# 长期生效:把两行 export 追加到 ~/.zshrc 或 ~/.bashrc,再执行 source ~/.zshrc
powershell
# 临时生效(只对当前窗口)
$env:ANTHROPIC_BASE_URL = "https://api.niceai.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude

# 长期生效(写入用户环境变量,需重新打开终端)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
bat
rem 长期生效,setx 只对之后新开的窗口生效
setx ANTHROPIC_BASE_URL "https://api.niceai.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

Windows 上的安装方式、WSL 和 Git Bash 的区别见 Windows 上使用 Claude Code。

验证 ​

  1. 重新打开终端,运行 claude。
  2. 在 Claude Code 里输入 /status,确认显示的 Base URL 是 https://api.niceai.dev。
  3. 随便问一句,能正常回复即接入成功。控制台的使用记录里也能看到这次请求。

切换模型 ​

在 Claude Code 中输入 /model 选择模型。可用模型以 模型广场 为准;也可以在 settings.json 的 env 里设置 ANTHROPIC_MODEL 指定默认模型。

常见问题 ​

返回 404? ​

ANTHROPIC_BASE_URL 末尾不要加 /v1,Claude Code 会自己拼接 /v1/messages。详见 接口地址要不要加 /v1。

返回 401? ​

检查密钥是否复制完整、是否被禁用、分组是否为 Claude。另外确认没有同时设置 ANTHROPIC_API_KEY 指向别的密钥,避免两个变量冲突。

改了配置但没生效? ​

环境变量只对新打开的终端生效。settings.json 和系统环境变量同时设置时容易互相干扰,建议只保留一处,或确认两边的值一致。

一句话的提问也消耗了几千输入 token? ​

Claude Code 每次请求都会带上自身的系统提示和工具定义,所以即使你只问一句,输入 token 也会有几千。这是客户端的正常行为,开启缓存的分组可以降低这部分成本,见 分组与倍率说明。

注意

不要把含有密钥的 settings.json 提交到 Git 仓库,也不要截图分享。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站