Claude Code

推荐使用 Claude Code 客户端

Claude Code 是 Anthropic 官方命令行工具，支持直接在本地执行 Python 脚本、读写文件、调用系统命令，是配合本平台使用体验最好的客户端。推荐优先使用。

下载地址：claude.ai/code

Claude Code 是 Anthropic 官方的命令行 AI 编程工具，支持代码编写、调试、重构、解释等任务，深度集成在终端工作流中。通过设置环境变量，将请求转发到 AI Gateway，使用你自己购买的额度。

首次使用：跳过登录引导

必须先完成此步骤

首次运行 Claude Code 时，如果不跳过登录引导，程序会尝试连接 Anthropic 官方服务器进行验证，导致连接失败。请在安装后、配置环境变量前先完成以下设置。

首次运行 Claude Code 时，可能会出现以下登录选择界面：

Claude Code can be used with your Claude subscription or billed based on
API usage through your Console account.

Select login method:
  1. Claude account with subscription · Pro, Max, Team, or Enterprise
  2. Anthropic Console account · API usage billing
  3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

已通过环境变量配置 API Key 的情况下，无需登录，可直接跳过此流程：

1. 找到用户主目录下的 .claude.json 文件：

   • macOS / Linux：~/.claude.json
   • Windows：C:\Users\%USERNAME%\.claude.json

2. 如果文件不存在，新建该文件；如果已存在，在其中添加或修改以下字段：

{
  "hasCompletedOnboarding": true
}

3. 保存文件后，重新运行 claude，不再出现登录引导。

提示

如果文件已有其他内容，只需在 JSON 对象中加入 "hasCompletedOnboarding": true 这一键值对，保留其他字段不变。

---

安装

需要 Node.js 18+：

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

---

Mac / Linux 配置

单次启动

打开终端，执行：

ANTHROPIC_API_KEY=sk-你的令牌 \
ANTHROPIC_BASE_URL=https://aigateway.link \
claude

永久生效

将以下内容添加到 ~/.zshrc（zsh）或 ~/.bashrc（bash）末尾：

export ANTHROPIC_API_KEY=sk-你的令牌
export ANTHROPIC_BASE_URL=https://aigateway.link

保存后执行使其立即生效：

source ~/.zshrc

之后直接运行 claude 即可，无需每次设置环境变量。

---

Windows 配置

方式一：PowerShell（推荐，当前窗口有效）

$env:ANTHROPIC_API_KEY="sk-你的令牌"
$env:ANTHROPIC_BASE_URL="https://aigateway.link"
claude

永久生效：打开 PowerShell 配置文件：

notepad $PROFILE

在文件末尾添加以下两行并保存，重启 PowerShell 后生效：

$env:ANTHROPIC_API_KEY="sk-你的令牌"
$env:ANTHROPIC_BASE_URL="https://aigateway.link"

方式二：CMD（当前窗口有效）

set ANTHROPIC_API_KEY=sk-你的令牌
set ANTHROPIC_BASE_URL=https://aigateway.link
claude

永久生效（对新终端窗口生效）：

setx ANTHROPIC_API_KEY "sk-你的令牌"
setx ANTHROPIC_BASE_URL "https://aigateway.link"

执行后重新打开终端窗口即可。

方式三：系统环境变量（图形界面）

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 在「用户变量」点击「新建」，分别添加：

变量名	变量值
ANTHROPIC_API_KEY	sk-你的令牌
ANTHROPIC_BASE_URL	https://aigateway.link

3. 点击确定，重启所有终端窗口后生效。

---

模型配置

AI Gateway 支持所有 Anthropic 模型（Claude Opus、Sonnet、Haiku 全系列）。模型的选择优先级从高到低：

优先级	方式	示例
1（最高）	会话内切换	/model claude-opus-4-7
2	启动时指定	claude --model claude-sonnet-4-6
3	环境变量	ANTHROPIC_MODEL=claude-haiku-4-5
4（最低）	settings.json	项目或主目录下的配置文件

不指定模型时，Claude Code 使用其默认模型。

---

多账号隔离

如果你同时有 Claude Pro 订阅和 AI Gateway 令牌，可以在不同终端分别使用：

• 终端 1：不设置任何环境变量，正常使用 Claude Code 的登录态（Pro 账号）
• 终端 2：按上述步骤设置环境变量，走 AI Gateway 计费

两个终端完全独立，互不干扰。

Windows 多账号注意

不要使用「系统环境变量」或 setx 方式——该方式会影响所有终端窗口。推荐用 PowerShell 单窗口临时设置（$env:ANTHROPIC_API_KEY=...）来隔离两个账号。

---

验证是否生效

启动 Claude Code 后发送任意消息，然后进入 AI Gateway 使用日志，如果能看到请求记录，说明已走 AI Gateway。

---

常见问题

zsh: command not found: claude

claude 命令不在 PATH 中，执行以下命令添加：

export PATH="$HOME/.claude/bin:$PATH"
# 或
export PATH="$HOME/.local/bin:$PATH"

并将上述行加入 ~/.zshrc 或 ~/.bashrc 永久生效。

提示 401 或 No token provided

在 Claude Code 会话中执行 /config，检查 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 是否正确设置。

Windows 上提示 Unable to connect to Anthropic services

通常是首次使用时 Claude Code 尝试连接 Anthropic 官方服务器做初始化检查导致的。按照上方「首次使用：跳过登录引导」章节操作，创建 .claude.json 文件后重试。

claude 命令存在但无法响应

检查环境变量是否在当前终端窗口中生效（用 PowerShell 临时 set 而非系统变量时，每次需重新设置）。