HAI Gateway

Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的命令行编程工具，可以直接在终端中通过自然语言与代码库交互——帮你分析代码、修复 Bug、编写新功能、处理 Git 工作流。

推荐使用 CC Switch 配置

若不想手动编辑环境变量，可使用 CC Switch 通过图形界面为 Claude Code 一键切换 HAI Gateway 等多家供应商，省去手动配置 ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL 的步骤。

环境依赖

安装前请先确认以下依赖已就绪

Claude Code 基于 Node.js 运行，安装前必须先安装 Node.js 和 npm。Git 为推荐安装项，用于代码版本管理。

依赖项	版本要求	必须	下载地址
Node.js	v18+	是	nodejs.org
npm	随 Node.js 安装	是	-
Git	v2.23+	推荐	git-scm.com

macOS 安装

步骤 1：安装依赖

# 使用 Homebrew 安装 Node.js 和 Git（推荐）
brew install node git
 
# 或者使用 nvm 安装 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc
nvm install --lts

验证安装：node --version 和 npm --version

步骤 2：安装 Claude Code

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

步骤 3：配置环境变量

将以下内容添加到 ~/.zshrc（如使用 bash 则添加到 ~/.bashrc）：

export ANTHROPIC_API_KEY="sk-pat-您的Access Token"
export ANTHROPIC_BASE_URL="https://api.hai.network/anthropic"
export API_TIMEOUT_MS="600000"

提示

高亮部分需要替换为您自己的实际值。

使配置生效：

source ~/.zshrc

步骤 4：跳过登录

创建 ~/.claude.json 文件以跳过官方登录流程：

cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

步骤 5：验证安装

claude --version

安装完成

如果看到版本号输出，说明安装成功。现在可以在任意项目目录下运行 claude 启动 AI 编程助手。

Windows 安装

步骤 1：安装依赖

下载并安装 Node.js LTS 版本（安装时勾选 "Add to PATH"，npm 会自动安装）
下载并安装 Git for Windows（推荐）

验证安装（打开新的 PowerShell 窗口）：

node --version
npm --version

步骤 2：安装 Claude Code

以管理员身份打开 PowerShell，运行：

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

步骤 3：配置环境变量

在 PowerShell 中运行以下命令（永久生效，对当前用户）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-pat-您的Access Token", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.hai.network/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "600000", "User")

必须重启终端

设置环境变量后，需要关闭并重新打开 PowerShell / CMD 窗口，环境变量才会生效。

步骤 4：跳过登录

在 CMD 中运行以下命令，创建跳过登录配置文件：

echo {"hasCompletedOnboarding": true} > %USERPROFILE%\.claude.json

步骤 5：验证安装

claude --version

配置说明

配置项	值	说明
ANTHROPIC_API_KEY	`sk-pat-xxx`	您在 HAI Gateway 平台创建的 Access Token
ANTHROPIC_BASE_URL	`https://api.hai.network/anthropic`	HAI Gateway 的 Anthropic API 代理地址
API_TIMEOUT_MS	`600000`	请求超时时间（10 分钟），防止复杂任务超时
~/.claude.json	`hasCompletedOnboarding: true`	跳过 Anthropic 官方登录流程

问题排查

问题	解决方案
`command not found: claude`	重启终端；macOS/Linux 运行 `source ~/.zshrc`
仍提示登录 / 跳转 Anthropic 官网	检查 `~/.claude.json` 是否存在且内容正确
npm 权限错误（EACCES）	macOS/Linux 使用 `sudo npm install -g ...`；Windows 以管理员身份运行
PowerShell "禁止运行脚本"	执行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
npm 全局路径不在 PATH	运行 `npm config get prefix`，将该路径/bin 添加到 PATH
API 连接超时	确认 `ANTHROPIC_BASE_URL` 设置正确，检查网络连接

卸载与重置

卸载 Claude Code

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

重置登录配置

macOS / Linux：

rm ~/.claude.json

Windows（CMD）：

del %USERPROFILE%\.claude.json