通过 CloseAI 使用 Claude Code 教程

Claude Code 是 Anthropic 推出的一款强大的编码助手，默认需要登录 Claude 官方账号并订阅每月服务。虽然官方未公开 API 接口，但 CloseAI 平台提供了兼容的代理支持。通过本教程，您可以使用 CloseAI API Key 直接接入 Claude Code，无需官方订阅。整个过程简单可靠，支持 macOS/Linux 和 Windows 系统。

更新日期： 2025/12/4

准备工作

在开始前，确保您已准备好以下内容：

CloseAI 账户：注册并登录 CloseAI。
CloseAI API Key：在账户仪表板中生成并复制（格式如 sk-xxxxxxxxxxxxxxxx）。
Node.js 和 npm：从 nodejs.org 下载安装 LTS 版本。

注意： 本教程优先推荐使用 ~/.claude/settings.json 配置方式，最稳定且无需系统环境变量。如果遇到问题，可参考备选方案。

macOS/Linux 用户配置指南

第一步：安装 Claude Code

在终端运行官方安装命令：

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

备选安装（如果网络问题）：

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

安装后，即可在任意目录使用 claude 命令。

第二步：配置 CloseAI 接入

使用配置文件覆盖环境变量，避免冲突。

创建配置目录：
```
mkdir -p ~/.claude
```
编辑 ~/.claude/settings.json（使用您喜欢的编辑器，如 nano 或 vim）：
```
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.openai-proxy.org/anthropic"
  }
}
```
配置说明：
- 将 sk-xxxxxxxxxxxxxxxx 替换为您的 CloseAI API Key。
- 重要： 不要添加 apiKeyHelper 字段，以免冲突。

此方式 100% 覆盖系统变量，确保稳定。

第三步：免登录配置

首次启动时，Claude Code 可能提示登录官方账号（VPN 下弹出登录，无 VPN 报错 Failed to connect to api.anthropic.com）。由于已配置 settings.json，它会自动使用 CloseAI，无需额外操作。

第四步：开始使用

进入项目目录，启动：

cd /path/to/your/project
claude

启动后，如果提示使用自定义 Key，选择 yes。即可进入交互式 REPL 会话，开始编码交互！

Windows 用户配置指南

重要提示： 必须使用 Git Bash（或 WSL/Docker）运行。CMD/PowerShell 环境变量处理不兼容，易导致错误。

第一步：安装必要软件

Node.js：从 nodejs.org 下载 LTS 版安装。
Git for Windows（必需）：
- 从 git-scm.com 下载安装，默认设置。
- 安装后，从开始菜单打开 Git Bash。

为什么用 Git Bash？

环境变量处理稳定。
备选：使用 WSL 或 Docker。

第二步：安装 Claude Code

在 Git Bash 中运行：

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

备选安装：

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

第三步：配置 CloseAI 接入

使用配置文件，避免系统变量差异。

创建目录：
```
mkdir -p ~/.claude
```

编辑配置文件：

notepad ~/.claude/settings.json

在记事本中添加并保存：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.openai-proxy.org/anthropic"
  }
}

配置说明： 同 macOS/Linux，替换 Key 并避免 apiKeyHelper。

第四步：跳过登录提示

同 macOS/Linux，配置后自动使用 CloseAI，无需登录。

第五步：开始使用

必须在 Git Bash 中操作：

cd /c/path/to/your/project  # 注意 Windows 路径用 /c/
claude

选择 yes 使用自定义 Key。享受编码！

警告： 勿用 CMD/PowerShell；若需其他终端，切换 WSL/Docker。

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

仅当 settings.json env 配置失效时使用。这是早期方案，最新 Claude Code 已支持 env，优先首选。

macOS/Linux 使用 apiKeyHelper

编辑 ~/.claude/settings.json：
```
{
  "apiKeyHelper": "~/.claude/closeai_api_key.sh"
}
```
注意： 移除 env 字段，避免冲突。

创建脚本 ~/.claude/closeai_api_key.sh：

#!/bin/sh
echo "sk-xxxxxxxxxxxxxxxx"  # 替换为您的 Key

设置权限：
```
chmod +x ~/.claude/closeai_api_key.sh
```
添加环境变量到 shell 配置文件（如 ~/.zshrc）：
```
export ANTHROPIC_BASE_URL="https://api.openai-proxy.org/anthropic"
```
生效：source ~/.zshrc。

Windows 使用 apiKeyHelper

编辑 ~/.claude/settings.json（用 notepad）：

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

在 Git Bash 创建脚本：

cat > ~/.claude/closeai_api_key.sh << 'EOF'
#!/bin/sh
echo "sk-xxxxxxxxxxxxxxxx"  # 替换 Key
EOF
chmod +x ~/.claude/closeai_api_key.sh

设置系统环境变量：
- 右键“此电脑” > 属性 > 高级系统设置 > 环境变量。
- 用户变量 > 新建：ANTHROPIC_BASE_URL = https://api.openai-proxy.org/anthropic。
- 关闭并重开 Git Bash 生效。

故障排查

使用表格快速定位常见问题：

问题类型	症状	解决方案
macOS/Linux 权限	`EACCES` 错误（npm install）	`sudo chown -R $(whoami) /usr/local/lib/node_modules` `sudo chown -R $(whoami) /usr/local/bin`
Windows 常见	各种兼容错误	始终用 Git Bash；备选 WSL/Docker。安装时以管理员运行 Git Bash。 npm 权限：`npm config set prefix ~/.npm-global`
环境变量不生效	配置后仍报错	优先用 `settings.json` env 方式。系统变量后，重开终端。
配置冲突	认证失败	移除 `apiKeyHelper`，仅用 `env`。检查 Key 无空格，有效配额。
登录提示	弹出官方登录	已配置 env，无需 VPN；直接选择自定义 Key。
API Key 问题	`Failed to connect` 或认证错	确认在 Git Bash（Windows）；Key 正确；配额充足。试增强配置： ```json:disable-run