Step 5: 安装 Claude Code

🗺️ 操作教程总览

1. 前置条件

安装 Claude Code 之前，请确认：

• 已完成 Step 4（Verge Clash 安装并开启 TUN 模式）
• 可以稳定访问 https://api.anthropic.com（用 curl 测试过）
• 已安装 Node.js 18+（Claude Code 基于 Node.js 构建）

2. 安装 Node.js

Claude Code 需要 Node.js 运行时环境。如果尚未安装，按以下步骤操作。

# 检查 Node.js 版本（需 >= 18）
node --version

# 如果未安装或版本过低，使用 Homebrew 安装
brew install node

# 或使用 nvm（Node 版本管理器，推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc
nvm install 20
nvm use 20
nvm alias default 20

# 检查 Node.js 版本
node --version

# 如果未安装，从官网下载 MSI 安装器
# https://nodejs.org/en/download
# 选择 LTS 版本（20.x），下载 Windows Installer (.msi)
# 运行安装程序，保持默认选项即可

# 或使用 nvm-windows（推荐）
# 下载安装器：https://github.com/coreybutler/nvm-windows/releases
# nvm install 20.11.0
# nvm use 20.11.0

3. 安装 Claude Code

Anthropic 通过 npm 分发 Claude Code。npm 是 Node.js 的包管理器，安装 Node.js 时自动附带。

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果权限不足，使用 sudo（不推荐，建议用 nvm）
# sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 如果提示不是 recognized command，检查 npm 全局安装路径是否在 PATH 中
# npm config get prefix
# 确保该路径下的 bin / Scripts 目录已添加到环境变量

4. 获取 Anthropic API Key

使用 Claude Code 需要 Anthropic API Key。

1. 访问 Anthropic Console
2. 注册 / 登录账号（支持邮箱注册）
3. 进入「Settings」→「API Keys」
4. 点击「Create Key」，输入名称（如 Personal）
5. 复制生成的 Key（格式如 sk-ant-api03-xxxxx）

5. 配置 Claude Code 登录

Claude Code 使用浏览器 OAuth 流程进行认证，无需手动设置环境变量。

# 在项目目录中启动 Claude Code
cd ~/Projects/openclaw-test
claude

# 首次启动会提示登录
# ? How would you like to authenticate? (Use arrow keys)
# > Sign in with your browser (Recommended)
#   Enter an API key manually

# 选择浏览器登录，系统会自动打开浏览器完成 OAuth 认证
# 认证完成后，终端中会显示登录成功

# 在项目目录中启动 Claude Code
cd C:\Projects\openclaw-test
claude

# 首次启动会提示登录方式
# 选择浏览器登录，系统会自动打开默认浏览器
# 完成 OAuth 认证后返回终端

6. 验证 Claude Code 运行

登录成功后，Claude Code 会显示交互式提示符。你可以开始与它对话。

# 你应该看到类似以下界面
# 🟣 Claude Code v0.x.x
# Working directory: /Users/you/Projects/openclaw-test
# 
# What would you like to work on?
# > 

# 输入一个测试问题
Write a Python script that fetches the current weather from a public API

# Claude Code 会分析需求、编写代码、展示给你确认
# 按 Ctrl+D 退出