准备工作
在开始之前,请确保您已经拥有:
- 一个 GAC 账户(如没有请发送任意邮件到ClaudeCode@163.com获取教程)
- 一个 GAC API Key。您可以在您的账户仪表板中找到它。
- 已安装 Node.js 和 npm。
Windows 用户配置指南
Windows 用户需要额外安装 Git Bash,并且在设置环境变量时有不同的方法。
第一步:安装 Node.js
访问 nodejs.org/ 下载并安装 LTS 版本的 Node.js。
第二步:安装 Git for Windows
- 访问 git-scm.com/downloads/w...
- 下载并安装 Git for Windows
- 安装过程中保持默认设置
安装完成后,您可以在开始菜单或右键菜单中找到 "Git Bash"。
第三步:安装 Claude Code
重要:必须在 Git Bash 中执行此命令
打开 Git Bash,运行以下命令:
bash
m install -g @anthropic-ai/claude-code
第四步:设置环境变量
设置系统环境变量
- 右键"此电脑" → "属性" → "高级系统设置"
- 点击"环境变量"按钮
- 在"用户变量"中点击"新建",添加以下两个变量:
变量 1:
- 变量名:
ANTHROPIC_BASE_URL
- 变量值:
https://api.openai-proxy.org/anthropic
变量 2:
- 变量名:
ANTHROPIC_API_KEY
- 变量值:
sk-xxxxxxxxxxxxxxxx
(替换为您的实际 API Key)
重要提醒:设置完环境变量后,请关闭并重新打开 PowerShell、CMD 或 Git Bash,确保环境变量生效。
验证环境变量设置
在 PowerShell 中运行以下命令验证:
bash
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
在 CMD 中验证:
bash
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_API_KEY%
第五步:开始使用
现在您可以在 PowerShell 或 CMD 中启动 Claude Code:
claude
如使用后提示403报错现"No Active Subscription " 提示联系请发送任意邮件ClaudeCode@163.com即可获取权限。如授权后提示403报错现"No Active Subscription " 提示联系请发送任意邮件到ClaudeCode@163.com即可获取权限。
第六步:跳过登录提示
Claude Code 首次启动时会需要你登录Claude官方账号,你如果挂了VPN,会弹出登录,如果没挂VPN会直接报错: Failed to connect to api.anthropic.com
,可以通过添加配置文件来跳过:
在用户目录下创建 .claude.json
文件(注意是 .claude.json
,不是 .claude
文件夹),添加以下内容:
json
{
"hasCompletedOnboarding": true
}
这个配置会告诉 Claude Code 跳过初始登录流程。
故障排查
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 常见问题
安装时提示 "permission denied" 错误
- 以管理员身份运行 PowerShell 或 Git Bash
- 或配置 npm 使用用户目录:
npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误
如果遇到执行策略限制,运行:
sql
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
环境变量设置后不生效
- 设置永久环境变量后需要重新启动 PowerShell 或 CMD
- 或者注销并重新登录 Windows
API Key 相关问题
如果遇到认证失败,请检查:
- API Key 是否正确复制(注意不要有多余的空格)
- 环境变量名是否正确(应该是
ANTHROPIC_API_KEY
,不是ANTHROPIC_AUTH_TOKEN
) - API Key 是否有效且有足够的配额
开始使用
恭喜您!所有配置都已完成。Claude Code 会启动一个交互式的 REPL 会话,您可以直接开始提问和交互。由于我们已经配置好了 API 接入点和 Key,它现在完全通过 CloseAI 平台运行。
在项目目录中使用 Claude Code:
bash
# 进入您的项目目录
cd /path/to/your/project
# 启动 Claude Code
claude
尽情享受由 CloseAI 驱动的强大编码体验吧!