Claude Code CLI 接入第三方 API 快速教程:环境变量配置方法
通过 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 和 ANTHROPIC_MODEL 让 Claude Code CLI 使用第三方 API,并说明不带 /v1 的 Base URL 特例。
Claude Code CLI 可以通过环境变量指定第三方模型接口。配置 NixAPI 后,你可以在终端里继续使用 claude 命令,同时把模型请求发送到 NixAPI。
这篇教程的重点是三个环境变量:
ANTHROPIC_BASE_URLANTHROPIC_API_KEYANTHROPIC_MODEL
需要特别注意:Claude Code CLI 的 ANTHROPIC_BASE_URL 这里填写 https://nixapi.com,不要带 /v1。
准备工作
先确认系统中有 Node.js:
node -v
建议使用 Node.js 18 或更高版本。如果没有安装,可以到 Node.js 官网下载安装包。
然后准备一个 NixAPI API Key。进入 NixAPI 控制台 创建即可。模型 ID 建议从 NixAPI 支持的模型列表页 复制。
第一步:安装 Claude Code CLI
macOS、Linux 或 WSL 用户可以使用原生安装脚本:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell 用户:
irm https://claude.ai/install.ps1 | iex
安装完成后验证:
claude --version
如果命令找不到,关闭终端重新打开,再检查安装脚本提示的 PATH 配置。
第二步:设置环境变量
macOS / Linux / WSL
在当前终端临时生效:
export ANTHROPIC_BASE_URL=https://nixapi.com
export ANTHROPIC_API_KEY=nix-your-api-key
export ANTHROPIC_MODEL=claude-sonnet-4-20250514
如果希望长期生效,可以写入 ~/.zshrc 或 ~/.bashrc:
echo 'export ANTHROPIC_BASE_URL=https://nixapi.com' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=nix-your-api-key' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL=claude-sonnet-4-20250514' >> ~/.zshrc
source ~/.zshrc
Windows PowerShell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://nixapi.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "nix-your-api-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-20250514", "User")
设置完成后关闭 PowerShell,再重新打开。
注意:这里的
ANTHROPIC_BASE_URL不写/v1。Claude Code CLI 会按自身 Anthropic 兼容逻辑拼接路径,写成https://nixapi.com/v1反而可能导致路径错误。
第三步:可选写入本地配置文件
如果你不想每次都依赖 shell 环境变量,可以在用户目录下创建:
- macOS / Linux:
~/.claude/config.json - Windows:
C:\Users\你的用户名\.claude\config.json
示例内容:
{
"env": {
"ANTHROPIC_BASE_URL": "https://nixapi.com",
"ANTHROPIC_API_KEY": "nix-your-api-key",
"ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
}
}
保存后重新打开终端。
第四步:启动 Claude Code
进入你的项目目录:
cd your-project
claude
如果之前登录过官方账号,并且启动时仍然要求官方鉴权,可以在 Claude Code 中执行:
/logout
然后重启 CLI,让它使用环境变量中的 NixAPI 配置。
进入界面后发送一个测试任务:
请阅读当前项目结构,并给出一个简短的代码质量检查清单。
能正常返回结果,就说明 Claude Code CLI 已接入 NixAPI。
模型选择建议
可以先从这些模型开始:
claude-sonnet-4-20250514:适合日常代码问答、修复和解释claude-opus-4-7:适合更复杂的架构分析和长任务gpt-5.4:适合通用代码和文本混合任务deepseek-v4:适合代码和推理任务对比
不同模型价格不同。正式跑长任务前,建议查看 NixAPI 模型价格页。NixAPI 当前也有限时充值兑换率:¥0.80 = $1.00。
常见问题
1. claude doctor 显示网络异常
先确认当前终端能读取环境变量:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
Windows PowerShell 使用:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
如果为空,说明环境变量没有生效。
2. 提示密钥错误
检查 ANTHROPIC_API_KEY 是否为 NixAPI 控制台创建的 Key,前后是否有空格。
3. 提示模型不存在
模型 ID 不匹配。打开 NixAPI 支持的模型列表页 复制准确名称。
4. 为什么这里 Base URL 不带 /v1?
这是 Claude Code CLI 的接入特例。它读取的是 ANTHROPIC_BASE_URL,路径拼接方式和 OpenAI SDK 的 base_url 不同。这里写:
https://nixapi.com
不要写:
https://nixapi.com/v1
小结
Claude Code CLI 接入 NixAPI 主要靠环境变量。只要 ANTHROPIC_BASE_URL=https://nixapi.com、ANTHROPIC_API_KEY 和 ANTHROPIC_MODEL 三项正确,终端里的 claude 就可以通过 NixAPI 调用模型。