CloseAI

Appearance

通过 CloseAI 使用 Claude Code ​

Claude Code 介绍图片

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

准备工作 ​

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

  1. 一个 CloseAI 账户。
  2. 一个 CloseAI API Key。您可以在您的账户仪表板中找到它。
  3. 已安装 Node.js 和 npm。

macOS/Linux 用户配置指南 ​

第一步：安装 Claude Code ​

运行claude官方安装命令

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

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

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

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

第二步：配置 CloseAI 接入 ​

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

1. 创建配置目录 ​

bash
mkdir -p ~/.claude

2. 编辑 settings.json ​

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

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

配置说明：

  • ANTHROPIC_API_KEY 设为您的 CloseAI API Key（请务必替换 sk-xxxxxxxxxxxxxxxx）
  • ANTHROPIC_BASE_URL 设为 CloseAI 的 API 地址
  • 重要：配置文件中，不要添加 apiKeyHelper 字段，否则会导致配置冲突

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

第三步：免登录配置 ​

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

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

第四步：开始使用 ​

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

bash
claude

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

Windows 用户配置指南 ​

重要提示：Windows 用户必须使用 Git Bash（或 WSL/Docker）来运行 Claude Code。在 CMD 或 PowerShell 中使用可能会遇到各种环境变量和兼容性问题。

第一步：安装必要软件 ​

1. 安装 Node.js ​

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

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

  1. 访问 https://git-scm.com/downloads/win
  2. 下载并安装 Git for Windows
  3. 安装过程中保持默认设置

安装完成后，您可以在开始菜单或右键菜单中找到 "Git Bash"。

为什么必须使用 Git Bash？

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

第二步：安装 Claude Code ​

请在 Git Bash 中执行以下操作

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

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

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

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

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

第三步：配置 CloseAI 接入 ​

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

在 Git Bash 中创建配置 ​

  1. 创建配置目录：
bash
mkdir -p ~/.claude
  1. 创建并编辑配置文件：
bash
# 使用 notepad 打开配置文件
notepad ~/.claude/settings.json
  1. 在打开的记事本中，添加以下内容并保存：
json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.openai-proxy.org/anthropic"
  }
}

配置说明：

  • ANTHROPIC_API_KEY 设为您的 CloseAI API Key（请务必替换 sk-xxxxxxxxxxxxxxxx）
  • ANTHROPIC_BASE_URL 设为 CloseAI 的 API 地址
  • 重要：配置文件中，不要添加 apiKeyHelper 字段，否则会导致配置冲突

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

第四步：跳过登录提示 ​

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

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

第五步：开始使用 ​

重要：必须在 Git Bash 中启动 Claude Code

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

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

不要使用 CMD 或 PowerShell，这是许多用户遇到问题的主要原因。如果您必须使用其他终端，建议使用 WSL 或 Docker 环境。

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

如果上述 settings.json 的 env 配置方式不生效，可以尝试使用 apiKeyHelper 脚本方式。这种方式通过脚本输出 API Key，而不是直接配置环境变量。注意备选方案是早期摸索的一种方案，当初claude并不支持环境变量的方案，一般最新版本claude无此问题，建议优先使用首选方案。

macOS/Linux 使用 apiKeyHelper 配置 ​

1. 修改 settings.json ​

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

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

注意：使用 apiKeyHelper 方式时，不要在 settings.json 中配置 env 字段，两种方式会冲突。

2. 创建 API Key 脚本 ​

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

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

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

3. 设置脚本权限 ​

bash
chmod +x ~/.claude/closeai_api_key.sh

4. 配置环境变量 ​

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

bash
export ANTHROPIC_BASE_URL="https://api.openai-proxy.org/anthropic"

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

Windows 使用 apiKeyHelper 配置 ​

1. 修改 settings.json ​

在 Git Bash 中编辑配置文件：

bash
notepad ~/.claude/settings.json

修改为：

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

注意：使用 apiKeyHelper 方式时，不要在 settings.json 中配置 env 字段，两种方式会冲突。

2. 创建 API Key 脚本 ​

在 Git Bash 中执行：

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

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

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

3. 配置系统环境变量 ​

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

重要提醒：设置完环境变量后，请关闭并重新打开 Git Bash，确保环境变量生效。

故障排查 ​

macOS/Linux 权限问题 ​

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

bash
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 配置方式：

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

这种方式可以：

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

API Key 相关问题 ​

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

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

开始使用 ​

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

在项目目录中使用 Claude Code：

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

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

Copyright © 2024 CloseAI