Claude Code 如何使用第三方 API？

第一步：安装 Claude Code

前置条件：安装 Node.js

Claude Code 通过 npm 安装，所以先要有 Node.js（版本 18 或以上）。

Mac：

推荐用 Homebrew 安装，干净省事：

# 如果还没装 Homebrew，先装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 再装 Node.js
brew install node

或者直接去 nodejs.org 下载 macOS 安装包，双击安装。

Windows：

去 nodejs.org 下载 LTS 版本的 Windows 安装包（.msi 文件），一路 Next 安装完成。

安装完后，打开终端验证：

node -v   # 应该显示 v18.x.x 或更高
npm -v    # 应该显示版本号

安装 Claude Code

Node.js 装好后，一行命令搞定：

npm install -g @anthropic-ai/claude-code

Windows 用户如果报权限错误，用管理员身份打开 PowerShell 再运行。

验证安装成功：

claude --version

能输出版本号就装好了。

首次登录

第一次运行 claude，它会引导你完成认证：

claude

终端会弹出一个链接，在浏览器里打开，用 Anthropic 账号登录授权，授权完回到终端就可以用了。

如果你打算用第三方 API（下面会讲），可以跳过官方登录，直接配置 Key 和端点就行。

第二步：配置第三方 API

Claude Code 本身调用的是 Anthropic 官方接口。但如果你在国内、或者想接入其他兼容 Anthropic 格式的服务商（比如 AWS Bedrock、Azure、各类中转代理），只需要修改两个环境变量，就能让 Claude Code 把请求发到你指定的地址。

核心原理

Claude Code 在启动时会读取以下两个环境变量：

变量名	作用
`ANTHROPIC_API_KEY`	鉴权用的 API Key，换成第三方给你的 Key
`ANTHROPIC_BASE_URL`	API 请求地址，默认是 Anthropic 官方，改成第三方端点

只要第三方服务的接口格式和 Anthropic 兼容，Claude Code 就能直接用，不需要改任何代码。

Mac 上的配置方法

方法一：永久生效（推荐）

打开终端，编辑 shell 配置文件：

# 如果你用的是 zsh（macOS 默认）
nano ~/.zshrc

# 如果你用的是 bash
nano ~/.bash_profile

在文件末尾加上这两行：

export ANTHROPIC_API_KEY="你的第三方Key"
export ANTHROPIC_BASE_URL="https://第三方的API地址"

保存后，让配置立即生效：

source ~/.zshrc

方法二：临时生效（只对当前终端窗口有效）

export ANTHROPIC_API_KEY="你的第三方Key"
export ANTHROPIC_BASE_URL="https://第三方的API地址"
claude  # 直接启动

验证是否生效

echo $ANTHROPIC_BASE_URL

输出你设置的地址，说明配置成功。然后直接运行 claude，它就会走第三方接口了。

Windows 上的配置方法

方法一：通过系统界面永久设置

按 Win + S，搜索 “编辑系统环境变量”，点击打开
点击右下角的 “环境变量” 按钮
在 “用户变量” 区域点击 “新建”，分别添加两个变量：
- 变量名：ANTHROPIC_API_KEY，变量值：你的第三方 Key
- 变量名：ANTHROPIC_BASE_URL，变量值：第三方 API 地址
点击确定，重启终端或 VS Code 使配置生效

方法二：PowerShell 临时设置

$env:ANTHROPIC_API_KEY = "你的第三方Key"
$env:ANTHROPIC_BASE_URL = "https://第三方的API地址"
claude

方法三：PowerShell Profile 永久设置

# 打开 Profile 文件
notepad $PROFILE

在文件中加入：

$env:ANTHROPIC_API_KEY = "你的第三方Key"
$env:ANTHROPIC_BASE_URL = "https://第三方的API地址"

保存后，每次打开 PowerShell 都会自动加载。

验证是否生效

echo $env:ANTHROPIC_BASE_URL

常见第三方服务的端点格式

不同服务商的端点格式略有不同，设置时需要注意：

服务商	`ANTHROPIC_BASE_URL` 示例
自建 / 中转代理	`https://your-proxy.com`
AWS Bedrock	通常需要用专用 SDK，不走这个变量
Vertex AI	同上，有独立配置方式
第三方兼容代理	`https://api.example.com/v1`

注意：URL 末尾一般不需要加斜杠，也不需要加 /messages，Claude Code 会自动拼接路径。

项目级配置（只对某个项目生效）

如果你不想影响全局设置，可以在项目根目录创建 .env 文件：

ANTHROPIC_API_KEY=你的第三方Key
ANTHROPIC_BASE_URL=https://第三方的API地址

Claude Code 会自动读取项目目录下的 .env 文件。记得把 .env 加进 .gitignore，避免 Key 泄露。

排查问题

如果配置后仍然报错，按以下顺序检查：

Key 是否正确：复制粘贴时注意不要带多余的空格
URL 格式：确认端点地址是否需要 /v1 后缀，以第三方文档为准
终端是否重启：系统环境变量修改后，必须重开终端才能生效
代理冲突：如果本地挂了 VPN 或代理，确认流量路由不冲突
运行 claude doctor：Claude Code 内置的诊断命令，会输出当前配置状态