Claude Code CLI 接入第三方 API 快速教程:环境变量配置方法

通过 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 和 ANTHROPIC_MODEL 让 Claude Code CLI 使用第三方 API,并说明不带 /v1 的 Base URL 特例。

NixAPI Team 2026年6月23日 约9 分钟阅读
Claude Code CLI 接入第三方 API 快速教程封面

Claude Code CLI 可以通过环境变量指定第三方模型接口。配置 NixAPI 后,你可以在终端里继续使用 claude 命令,同时把模型请求发送到 NixAPI。

这篇教程的重点是三个环境变量:

  • ANTHROPIC_BASE_URL
  • ANTHROPIC_API_KEY
  • ANTHROPIC_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.comANTHROPIC_API_KEYANTHROPIC_MODEL 三项正确,终端里的 claude 就可以通过 NixAPI 调用模型。

立即体验 NixAPI

稳定可靠的大语言模型 API 中转,支持 OpenAI、Claude、Gemini、DeepSeek、Qwen、Grok,充值 ¥0.8 = $1

免费注册