Claude Code 安装使用教程

Claude Code 是一个强大的 AI 编程助手，让您可以直接在终端中与 AI 协作编程。本教程将指导您完成安装和配置过程。

📋 系统要求

  • Node.js 版本 ≥ 18.0
  • 支持的操作系统：macOS、Linux、Windows (WSL)

🚀 快速开始

1. 安装 Node.js

💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Ubuntu / Debian 用户

# 安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# 验证安装
node --version

macOS 用户

# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version

2. 安装 Claude Code

使用 npm 全局安装 Claude Code：

# 官方安装方法 macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash
# 官方安装方法 windows
irm https://claude.ai/install.ps1 | iex
# 官方安装方法 Homebrew
brew install --cask claude-code
# 官方安装方法 Winget
winget install Anthropic.ClaudeCode

##安装完成后，claude会提示配置环境变量
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

3. 令牌获取

获取必要的配置信息

您需要准备两个重要的配置项：

配置项 说明 获取方式
ANTHROPIC_AUTH_TOKEN API 认证令牌 注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头）

| ANTHROPIC_BASE_URL | API 服务地址 | 与主站地址相同

📝 创建令牌时的建议设置：

  • 名称：随意命名
  • 额度：设为无限额度
  • 分组：选择Claude code专属、特价 Claude Code或者官转克劳德1及以上，不要选择default和逆向分组，这两个分组不支持工具调用
  • 其他选项：保持默认设置
### 4. settings.json配置

# 完整settings.json配置文件展示
  {
    "env": {
         "ANTHROPIC_BASE_URL": "主站地址url",  
    # 您的api令牌
    "ANTHROPIC_AUTH_TOKEN": "sk-*********",  
    # 交互主模型
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    # Explore子代理、对话摘要等轻量后台任务
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-6", 
    # opusplan模式下的执行阶段
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-6",
    # opusplan模式下的规划阶段
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    # 设置300秒超时
    "API_TIMEOUT_MS": "300000",  
    # 启用claude code发送给api的实验性beta内容
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    }
  }

Linux/Unix/Mac OS/Windows wsl 配置settings.json

# 进入项目目录，通常为根目录下的.claude文件夹
cd your-project-folder

# 第一步 输入以下命令后enter
cat > ~/.claude/settings.json << 'EOF'

# 第二步 替换令牌与合适的模型后，删除注释并输入以下命令后enter
  {
    "env": {
    "ANTHROPIC_BASE_URL": "主站地址url",  
    # 您的api令牌
    "ANTHROPIC_AUTH_TOKEN": "sk-*********",  
    # 交互主模型
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    # Explore子代理、对话摘要等轻量后台任务
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-6", 
    # opusplan模式下的执行阶段
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-6",
    # opusplan模式下的规划阶段
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    # 设置300秒超时
    "API_TIMEOUT_MS": "300000",  
    # 启用claude code发送给api的实验性beta内容
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    }
  }
  
  # 第三步 输入以下命令后enter
  EOF
  
  # 第四步 输入以下命令后enter，校验是否配置成功
  cat ~/.claude/settings.json
  
  # 第五步 配置成功后，直接使用以下命令启动claude code
  claude

初次运行配置

启动后，您将看到以下配置步骤：

  1. 选择主题 → 选择您喜欢的主题 + 按 Enter
  2. 安全须知 → 确认安全须知 + 按 Enter
  3. Terminal 配置 → 使用默认配置 + 按 Enter
  4. 工作目录信任 → 信任当前目录 + 按 Enter

✨ 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！

❓ 常见问题解答

Q: 遇到 "Invalid API Key · Please run /login" 错误？

A: 这表明 Claude Code 未检测到环境变量。请检查：

  • 是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
  • 环境变量值是否正确（令牌以 sk- 开头）
  • 如果使用了永久配置，是否重启了终端

Q: 为什么显示 "offline" 状态？

A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。

Q: 为什么浏览网页的 Fetch 会失败？

A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

  • 保持稳定的国际互联网连接
  • 必要时使用全局代理

Q: 请求总是显示 "fetch failed"？

A: 可能是网络环境导致的问题。解决方案：

  1. 尝试使用代理工具

Q: API 报错如何处理？

A: 可能是转发代理不稳定导致的，建议：

  • 退出 Claude Code（Ctrl+C）
  • 重新运行 claude 命令
  • 如果问题持续，请稍后再试

Q: 网页登录错误？

A: 尝试清除本站的 Cookie，然后重新登录。

📌 注意事项

  • 本站直接接入官方 Claude Code 转发服务
  • 仅支持 Claude Code 的 API 流量，不支持其他 API 调用
  • 请妥善保管您的 API 令牌，避免泄露

🔗 相关链接

💡 提示：如遇到其他问题，请查看官方文档或联系技术支持。