Claude Code 安装指南

跟着这个教程,你可以轻松在自己的电脑上安装 Claude Code。

1安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Windows 安装方法 (二选一,推荐方法一)

方法一:官网下载(推荐)

  1. 打开浏览器访问 Node.js 下载页面
  2. 点击 "LTS" 版本进行下载(推荐长期支持版本)
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装,保持默认设置即可

方法二:使用包管理器

如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装:

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs
Windows 注意事项
  • • 建议使用 PowerShell 而不是 CMD
  • • 如果遇到权限问题,尝试以管理员身份运行
  • • 某些杀毒软件可能会误报,需要添加白名单
验证安装是否成功

安装完成后,打开 PowerShell 或 CMD,输入以下命令:

node --version
npm --version

如果显示版本号,说明安装成功了!

2安装 Claude Code
安装 Claude Code
如何打开 PowerShell:
  1. 按下键盘上的 Win + X 组合键
  2. 在弹出的菜单中选择"Windows PowerShell"或"终端"
  3. 或者:按 Win 键,输入"PowerShell",然后回车

打开 PowerShell 或 CMD 后,运行以下命令:

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

常见报错:PowerShell 执行策略限制

如果在运行 npm 命令时出现以下错误:

npm : 无法加载文件 D:\\Program Files\\nodejs\\npm.ps1,
因为在此系统上禁止运行脚本。

解决方案:

  1. 以管理员身份打开 PowerShell:
    • 右键点击开始菜单
    • 选择"Windows PowerShell (管理员)"或"终端 (管理员)"
  2. 运行以下命令:
    Set-ExecutionPolicy RemoteSigned
  3. 确认更改:

    当系统询问时,输入 Y 或者 A,然后按回车。

  4. 重新运行安装命令:

    可以关闭管理员窗口,打开普通 PowerShell 窗口,再次运行 npm install -g @anthropic-ai/claude-code 命令。

✅ 完成后,npm 命令就可以正常使用了。

验证 Claude Code 安装

安装完成后,输入以下命令检查是否安装成功:

claude --version

如果显示版本号,恭喜你!Claude Code 已经成功安装了。

⚠️ 提示:如果运行 claude --version 时提示需要 Git Bash,请参考下方"步骤 4"中的 Git 报错解决方案。

3设置环境变量
配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:

PowerShell 设置方法
永久设置(强烈推荐)

在 PowerShell 中运行以下命令设置用户级环境变量:

# 设置用户级环境变量(永久生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cclaude.codes/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

临时设置(当前会话有效,不推荐)

在 PowerShell 中运行以下命令:

$env:ANTHROPIC_BASE_URL = "https://cclaude.codes/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

⚠️ 关闭窗口后设置会失效。

CMD 设置方法
永久设置(强烈推荐)

在 CMD 中运行以下命令设置用户级环境变量:

setx ANTHROPIC_BASE_URL "https://cclaude.codes/api"
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"

💡 设置后需要重新打开 CMD 窗口才能生效。

临时设置(当前会话有效,不推荐)

在 CMD 中运行以下命令:

set ANTHROPIC_BASE_URL=https://cclaude.codes/api
set ANTHROPIC_AUTH_TOKEN=你的API密钥

⚠️ 关闭窗口后设置会失效。

💡 记得将 "你的API密钥" 替换为实际密钥。

验证环境变量设置

设置完环境变量后,可以通过以下命令验证:

PowerShell:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

CMD:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
4开始使用 Claude Code

现在你可以开始使用 Claude Code 了!

启动 Claude Code
claude

💡 首次启动提示:第一次启动 claude 时,会展示一些配置选项,直接按回车跳过即可,直到出现输入框可以输入内容。

在特定项目中使用
# 进入你的项目目录
cd C:\path\to\your\project
# 启动 Claude Code
claude
常见报错:缺少 Git Bash

如果在运行 claude 命令时出现以下提示:

Claude Code on Windows requires git-bash...

解决方案:

  1. 下载 Git:
  2. 安装 Git:

    双击下载的安装包,一路点击"下一步",保持默认设置即可。

  3. 重新运行 claude:

    安装完成后,重新打开 PowerShell 或 CMD,运行 claude 命令即可正常使用。

✅ Git 安装完成后,claude 命令就可以正常运行了。

Windows 常见问题解决
安装时提示 "permission denied" 错误

这通常是权限问题,尝试以下解决方法:

  • 以管理员身份运行 PowerShell
  • 或者配置 npm 使用用户目录:npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误

如果遇到执行策略限制,运行:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
环境变量设置后不生效

设置永久环境变量后需要:

  • 重新启动 PowerShell 或 CMD
  • 或者注销并重新登录 Windows
  • 验证设置:echo $env:ANTHROPIC_BASE_URL