Claude Code 安装使用教程
📋 系统要求
🚀 快速开始
1. 安装 Node.js
💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。
🖥️ 各操作系统安装指南
🍎 macOS 安装教程
方法一：使用 Homebrew（推荐）
方法二：官方安装包
安装 Claude Code
环境变量配置
🪟 Windows 安装教程（PowerShell）
安装 Node.js
# 以管理员身份运行 PowerShell
# 安装 Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# 安装 Node.js
choco install nodejs
# 验证安装
node --version
npm --version# 安装 Node.js
winget install OpenJS.NodeJS
# 验证安装
node --version
npm --version安装 Claude Code
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version环境变量配置
# 设置环境变量（当前 PowerShell 会话有效）
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:ANTHROPIC_BASE_URL = "https://bestapi.aqi.email"
# 验证设置
Write-Host "Token: $env:ANTHROPIC_AUTH_TOKEN"
Write-Host "Base URL: $env:ANTHROPIC_BASE_URL"# 永久设置用户环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-...", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://bestapi.aqi.email", "User")
# 重启 PowerShell 使设置生效1.
Win + R，输入 sysdm.cpl2.
3.
4.
ANTHROPIC_AUTH_TOKEN，变量值：sk-...ANTHROPIC_BASE_URL，变量值：https://bestapi.aqi.email🐧 Linux 安装教程
Ubuntu / Debian 系统
CentOS / RHEL / Fedora 系统
Arch Linux 系统
安装 Claude Code
环境变量配置
⚙️ 通用配置步骤
获取必要的配置信息
| 配置项 | 说明 | 获取方式 |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头） |
| ANTHROPIC_BASE_URL | API 服务地址 | 使用 https://bestapi.aqi.email（与主站地址相同） |
📝 创建令牌时的建议设置： 名称：随意命名 额度：设为无限额度 分组：纯AZ或者其他官转分组（纯AZ为最低价用code分组，默认分组为逆向不可用） 其他选项：保持默认设置
启动 Claude Code
# 进入项目目录
Set-Location your-project-folder
# 启动 Claude Code
claude初次运行配置
1.
2.
3.
4.
🔧 命令对比表
| 操作 | macOS/Linux | Windows PowerShell |
|---|---|---|
| 查看 Node.js 版本 | node --version | node --version |
| 全局安装包 | npm install -g package | npm install -g package |
| 设置环境变量（临时） | export VAR=value | $env:VAR = "value" |
| 查看环境变量 | echo $VAR | Write-Host $env:VAR |
| 进入目录 | cd directory | Set-Location directory |
| 列出文件 | ls | Get-ChildItem 或 ls |
| 清屏 | clear | Clear-Host 或 cls |
❓ 常见问题解答
Q: 遇到 "Invalid API Key · Please run /login" 错误？
ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URLsk- 开头）Q: Windows 下 PowerShell 执行策略错误？
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserQ: Linux 下 npm 权限错误？
Q: 为什么显示 "offline" 状态？
Q: macOS 下提示 "command not found: claude"？
Q: 为什么浏览网页的 Fetch 会失败？
Q: 请求总是显示 "fetch failed"？
1.
Q: API 报错如何处理？
claude 命令Q: 网页登录错误？
📌 注意事项
🔗 相关链接
修改于 2025-07-16 08:18:37