外观
Claude Code 接入自定义 API
Claude Code 通过两个环境变量决定请求发到哪里、用什么密钥:
| 环境变量 | 填写内容 |
|---|---|
ANTHROPIC_BASE_URL | https://api.niceai.dev(不要加 /v1) |
ANTHROPIC_AUTH_TOKEN | 你的 NiceAI API 密钥 |
如果你已经装了 CC Switch,可以直接用 CC Switch 一键导入,不用手动改配置。下面是手动配置的方法。
准备工作
- 安装 Claude Code(参考其官方文档)。
- 在 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 ~/.zshrcpowershell
# 临时生效(只对当前窗口)
$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。
验证
- 重新打开终端,运行
claude。 - 在 Claude Code 里输入
/status,确认显示的 Base URL 是https://api.niceai.dev。 - 随便问一句,能正常回复即接入成功。控制台的使用记录里也能看到这次请求。
切换模型
在 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 仓库,也不要截图分享。