Claude Code 使用教程

Claude Code 需要 Node.js 运行环境。请访问官网下载并安装：

验证安装：

node --version
npm --version

应显示类似 v20.x.x 和 10.x.x 的版本号

使用 npm 全局安装 Claude Code CLI：

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

验证安装：

claude doctor

此命令会检查 Claude Code 安装是否正确

配置 Claude Code 使用中转服务：

方法 1: 临时设置（当前会话）

方法 2: 永久设置（用户环境变量）

如果使用 VSCode Claude Code 插件，需要配置环境变量：

方法 1: 使用配置文件

创建或编辑 ~/.claude/config.json：

{
  "primaryApiKey": "你的API密钥"
}

方法 2: VSCode settings.json (推荐)

在 VSCode 设置中添加：

启动 Claude Code CLI：

claude

问题 1: 找不到 claude 命令

原因： npm 全局安装路径未添加到 PATH
解决： 重启终端，或手动添加 npm 全局路径到系统 PATH

问题 2: 环境变量未生效

解决： 关闭所有 PowerShell/CMD 窗口，重新打开

问题 3: API 连接失败

检查项：

• API 密钥是否正确（包含 cr_ 前缀）
• 基础 URL 是否正确配置
• 网络连接是否正常
• 防火墙是否阻止连接

问题 4: Windows Defender 阻止

症状： 安装或运行时被 Windows Defender 阻止
解决： 在 Windows 安全中心添加例外，允许 Node.js 和 Claude Code 运行

Claude Code 需要 Node.js 运行环境：

方法 1: 使用 Homebrew (推荐)

brew install node

方法 2: 从官网下载

验证安装：

node --version
npm --version

使用 npm 全局安装 Claude Code CLI：

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

验证安装：

claude doctor

配置 Claude Code 使用中转服务：

方法 1: 临时设置（当前会话）

方法 2: 永久设置

添加到 shell 配置文件：

如果使用 VSCode Claude Code 插件：

方法 1: 使用配置文件

{
  "primaryApiKey": "你的API密钥"
}

方法 2: VSCode settings.json (推荐)

启动 Claude Code CLI：

claude

问题 1: 找不到 claude 命令

解决： 确认 npm 全局路径在 PATH 中，或使用 which claude 检查

问题 2: 环境变量未生效

解决： 运行 source ~/.zshrc 或 source ~/.bash_profile

问题 3: API 连接失败

检查项： API Key、base_url 配置、网络连接

Claude Code 需要 Node.js 运行环境：

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

Arch Linux:

sudo pacman -S nodejs npm

验证安装：

node --version
npm --version

使用 npm 全局安装 Claude Code CLI：

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

验证安装：

claude doctor

配置 Claude Code 使用中转服务：

方法 1: 临时设置（当前会话）

方法 2: 永久设置

添加到 shell 配置文件：

如果使用 VSCode Claude Code 插件：

方法 1: 使用配置文件

{
  "primaryApiKey": "你的API密钥"
}

方法 2: VSCode settings.json (推荐)

启动 Claude Code CLI：

claude

问题 1: 找不到 claude 命令

解决： 确认 npm 全局路径在 PATH 中，或使用 sudo npm install -g @anthropic-ai/claude-code 重新安装

问题 2: 环境变量未生效

解决： 运行 source ~/.bashrc 或 source ~/.zshrc，或重新打开终端

问题 3: 权限错误

解决： 使用 sudo 安装，或配置 npm 使用用户目录