通过 AI POOL 使用 Claude Code#

Claude Code 是 Anthropic 推出的一款强大的编码助手，默认情况下，必须登录 Claude 账号才能使用，需要购买官方的每月订阅。虽然 Claude Code 本身支持 API 直接调用的，但是官方并没有暴露出来，为了让所有 AI POOL 的用户可以使用，我们特别研发了一个脚本，可以直接用 AI POOL API Key 使用。

准备工作#

在开始之前，请确保您已经拥有：

• 一个 AI POOL 账户
• 一个 AI POOL API Key（您可以在您的账户仪表板中找到它）
• 已安装 Node.js 和 npm

macOS/Linux 用户配置指南#

第一步：安装 Claude Code#

运行 claude 官方安装命令：

curl -fsSL https://claude.ai/install.sh | bash

备选方案，如果因为网络不通等问题，也可以使用 npm (Node Package Manager) 在您的系统上全局安装 Claude Code。打开您的终端并运行以下命令：

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

安装完成后，您就可以在终端的任何位置使用 claude 命令了。

第二步：配置 AI POOL 接入#

通过 ~/.claude/settings.json 配置环境变量，这种方式最稳定可靠，无需配置系统环境变量，避免各种环境变量冲突问题。

1. 创建配置目录#

mkdir -p ~/.claude

2. 编辑 settings.json#

在您喜欢的文本编辑器中打开 ~/.claude/settings.json 文件，添加以下内容：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai-gate.haozcloud.com"
  }
}

配置说明：

• ANTHROPIC_API_KEY 设为您的 AI POOL API Key（请务必替换 sk-xxxxxxxxxxxxxxxx）
• ANTHROPIC_BASE_URL 设为 AI POOL 的 API 地址

这种配置方式会覆盖系统环境变量，确保 100% 正常工作，无需额外配置系统环境变量。

第三步：免登录配置#

Claude Code 首次启动时会需要你登录 Claude 官方账号，你如果挂了 VPN，会弹出登录，如果没挂 VPN 会直接报错: Failed to connect to api.anthropic.com。

由于我们已经在 settings.json 中配置了环境变量，Claude Code 会自动使用这些配置，无需额外的免登录配置。

第四步：开始使用#

现在，您可以在终端中启动 Claude Code 了：

claude

启动后 Claude 会问你是否使用自定 key，选择 yes。

Windows 用户配置指南#

第一步：安装必要软件#

1. 安装 Node.js#

访问 https://nodejs.org/ 下载并安装 LTS 版本的 Node.js。

2. 安装 Git for Windows（必需）#

• 访问 https://git-scm.com/downloads/win
• 下载并安装 Git for Windows
• 安装过程中保持默认设置
• 安装完成后，您可以在开始菜单或右键菜单中找到 "Git Bash"

为什么必须使用 Git Bash？

• CMD 和 PowerShell 的环境变量处理方式不同，容易导致兼容性问题
• Claude Code 在 Git Bash 中运行最稳定
• 如果您熟悉 WSL 或 Docker，也可以使用这些环境

第二步：安装 Claude Code#

打开 Git Bash，运行以下命令：

curl -fsSL https://claude.ai/install.sh | bash

备选方案，如果因为网络不通等问题，也可以使用 npm (Node Package Manager) 在您的系统上全局安装 Claude Code。打开您的终端并运行以下命令：

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

安装完成后，您就可以在终端的任何位置使用 claude 命令了。

第三步：配置 AI POOL 接入#

通过配置文件设置环境变量，这是 Windows 下最稳定的方式，无需配置系统环境变量，避免 CMD 和 PowerShell 的环境变量差异问题。

在 Git Bash 中创建配置#

1. 创建配置目录：

mkdir -p ~/.claude

2. 创建并编辑配置文件：

# 使用 notepad 打开配置文件
notepad ~/.claude/settings.json

在打开的记事本中，添加以下内容并保存：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai-gate.haozcloud.com"
  }
}

配置说明：

• ANTHROPIC_API_KEY 设为您的 AI POOL API Key（请务必替换 sk-xxxxxxxxxxxxxxxx）
• ANTHROPIC_BASE_URL 设为 AI POOL 的 API 地址

这种配置方式会覆盖系统环境变量，确保 100% 正常工作，无需额外配置系统环境变量。

第四步：跳过登录提示#

Claude Code 首次启动时会需要你登录 Claude 官方账号，你如果挂了 VPN，会弹出登录，如果没挂 VPN 会直接报错: Failed to connect to api.anthropic.com。

由于我们已经在 settings.json 中配置了环境变量，Claude Code 会自动使用这些配置，无需额外的免登录配置。

第五步：开始使用#

# 进入您的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude

启动后 Claude 会问你是否使用自定 key，选择 yes。

备选方案：使用 apiKeyHelper 脚本配置#

如果上述 settings.json 的 env 配置方式不生效，可以尝试使用 apiKeyHelper 脚本方式。这种方式通过脚本输出 API Key，而不是直接配置环境变量。

macOS/Linux 使用 apiKeyHelper 配置#

1. 修改 settings.json#

编辑 ~/.claude/settings.json 文件：

{
  "apiKeyHelper": "~/.claude/ai_pool_api_key.sh"
}

2. 创建 API Key 脚本#

创建 ~/.claude/ai_pool_api_key.sh 文件并填入以下内容：

#!/bin/sh
echo "sk-xxxxxxxxxxxxxxxx"

请务必将 sk-xxxxxxxxxxxxxxxx 替换为您自己的 AI POOL API Key。

3. 设置脚本权限#

chmod +x ~/.claude/ai_pool_api_key.sh

4. 配置环境变量#

将以下命令添加到您的 shell 配置文件中（例如 ~/.zshrc、~/.bashrc 或 ~/.bash_profile）：

export ANTHROPIC_BASE_URL="https://ai-gate.haozcloud.com"

通过运行 source ~/.zshrc (或相应的文件) 来使更改立即生效。

Windows 使用 apiKeyHelper 配置#

1. 修改 settings.json#

在 Git Bash 中编辑配置文件：

notepad ~/.claude/settings.json

修改为：

{
  "apiKeyHelper": "~/.claude/ai_pool_api_key.sh"
}

2. 创建 API Key 脚本#

在 Git Bash 中执行：

# 创建脚本文件
cat > ~/.claude/ai_pool_api_key.sh << 'EOF'
#!/bin/sh
echo "sk-xxxxxxxxxxxxxxxx"
EOF

# 设置权限
chmod +x ~/.claude/ai_pool_api_key.sh

请务必将 sk-xxxxxxxxxxxxxxxx 替换为您自己的 AI POOL API Key。

3. 配置系统环境变量#

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"按钮
3. 在"用户变量"中点击"新建"，添加：
   • 变量名：ANTHROPIC_BASE_URL
   • 变量值：https://ai-gate.haozcloud.com

故障排查#

macOS/Linux 权限问题#

在执行 npm install -g @anthropic-ai/claude-code 命令时，您可能会遇到 EACCES 权限错误。解决方法：

sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin

Windows 常见问题#

必须使用 Git Bash#

最重要：很多 Windows 用户报错都是因为使用了 CMD 或 PowerShell。这些终端的环境变量处理方式不同，会导致各种兼容性问题。

解决方案：

• 始终在 Git Bash 中安装和使用 Claude Code
• 或者使用 WSL（Windows Subsystem for Linux）
• 或者使用 Docker 环境

安装时提示 "permission denied" 错误#

• 以管理员身份运行 Git Bash
• 或配置 npm 使用用户目录：npm config set prefix ~/.npm-global

环境变量设置后不生效#

• 推荐使用 ~/.claude/settings.json 配置方式，可以完全避免此问题
• 如果使用系统环境变量，设置后需要关闭并重新打开 Git Bash

配置相关问题#

推荐使用 settings.json 配置#

如果遇到各种环境变量相关的报错，强烈建议使用 ~/.claude/settings.json 配置方式：

{
  "env": {
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai-gate.haozcloud.com"
  }
}

这种方式可以：

• 覆盖系统环境变量，避免冲突
• 避免 CMD/PowerShell 和 Git Bash 之间的环境变量差异
• 确保配置 100% 生效

API Key 相关问题#

如果使用系统环境变量方式遇到认证失败，请检查：

• 是否在 Git Bash 中运行（Windows 用户）
• API Key 是否正确复制（注意不要有多余的空格）
• 环境变量名是否正确
• API Key 是否有效且有足够的配额

开始使用#

恭喜您！所有配置都已完成。Claude Code 会启动一个交互式的 REPL 会话，您可以直接开始提问和交互。由于我们已经配置好了 API 接入点和 Key，它现在完全通过 AI POOL 平台运行。

在项目目录中使用 Claude Code：

# 进入您的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude

尽情享受由 AI POOL 驱动的强大编码体验吧！