windows 安装claude code 教程

在 Windows 上安装 Claude Code 教程

Claude Code 是 Anthropic 推出的 AI 编程助手，可以直接在终端中运行，帮助你理解代码库、编辑文件和执行任务。Claude code 可以安装在Linux / macOS / windows 平台上。本教程将指导你在 Windows 10 系统上安装和配置 Claude Code。

前置条件

在开始之前，请确保你的系统满足以下要求：

操作系统: Windows 10 (建议版本 2004 或更高) 或 Windows 11。
Anthropic 账号: 需要一个有效的 Anthropic 账号（用于 API 访问）。
网络连接: 需要连接互联网下载依赖包。

安装方法

我们提供两种安装方法。方法一 是直接在 cmd 中安装，适合不想安装 Linux 子系统的用户。方法二 使用 WSL 2，这是开发者的最佳实践环境。

方法一：直接在 Windows (cmd) 上安装

如果你更习惯使用原生 Windows 环境：

1. 安装 Node.js

访问 Node.js 官网。
下载适合的安装包，然后双击安装 LTS 版本 (推荐 v18 或更高)。
安装完成后，验证是否安装成功。
打开 CMD （使用快捷键 Win + R, 输入 cmd 并回车），输入 node -v 确认安装成功。

2. 安装 git （推荐安装）

访问 git官网
下载并安装git

2. 安装 Claude Code

打开 CMD，运行以下命令：

powershell 复制代码

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

方法二：使用 WSL 2

WSL (Windows Subsystem for Linux) 能提供更稳定、兼容性更好的开发环境。

1. 安装 WSL

如果你的电脑尚未安装 WSL，请打开 PowerShell (以管理员身份运行) 并输入以下命令：

powershell 复制代码

wsl --install

安装完成后，请重启电脑。重启后 WSL 会自动启动并引导你完成 Ubuntu 的设置（设置用户名和密码）。

2. 在 WSL (Ubuntu) 中安装环境

打开 Ubuntu 应用（或在终端中输入 wsl），然后依次运行以下命令更新系统并安装 Node.js (需要 v18+)。

bash 复制代码

# 更新包列表
sudo apt update

# 安装 Node.js 和 npm
# 推荐使用 nvm (Node Version Manager) 安装，这里提供直接安装命令作为快速方式:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v
npm -v

3. 安装 Claude Code

在 Ubuntu 终端中执行：

bash 复制代码

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

认证配置 (关键步骤)

Claude Code 需要通过 API Key 来访问 Anthropic 的服务。我们推荐通过设置环境变量的方式来配置 Key。

第一步：获取 API Key

访问 console.anthropic.com。
登录你的账号。
点击 Get API Keys ，创建一个新的 Key (以 sk- 开头)。
复制这个 Key，保管好它 (只会显示一次)。

第二步：配置环境变量

根据你选择的安装方式（WSL 或 cmd），选择对应的方法。

场景 A：如果你使用的是 Windows (cmd)

你需要设置用户级的环境变量。

在 cmd 中运行以下命令 (将 sk-xxxx-xxxxxx 替换为你的真实 Key)：
cmd 复制代码
```
set ANTHROPIC_API_KEY= sk-xxxx-xxxxxx
set ANTHROPIC_BASE_URL=https://xxxxxx
```

验证是否设置成功：

cmd 复制代码

echo:%ANTHROPIC_API_KEY%
echo %ANTHROPIC_BASE_URL%

场景 A：如果你使用的是 WSL (Ubuntu)

推荐将 Key 写入到 ~/.bashrc 文件中，这样每次打开终端都会自动生效。

在 Ubuntu 终端执行以下命令 (将 sk-proj-xxxxxx 替换为你的真实 Key)：

bash 复制代码

echo "export ANTHROPIC_API_KEY='sk-xxxx-xxxxxx'" >> ~/.bashrc
echo "export ANTHROPIC_BASE_URL='https://xxxxxx'" >> ~/.bashrc
source ~/.bashrc

验证是否设置成功：
bash 复制代码
```
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
```
如果输出了配置的变量，说明配置成功。

验证与使用

配置好 API Key 后，就可以启动 Claude Code 了。

在终端（WSL 或 cmd）中运行：
cmd 复制代码
```
cd your-project-folder
claude
```
如果 API Key 配置正确，你将直接进入 Claude Code 的交互界面，或者提示你选择主题等初始化设置，而不会要求你重新登录。

基本使用

Claude Code 安装好后，你可以直接在项目目录下使用它。

启动 Claude Code :
进入你的项目文件夹，输入：
bash 复制代码
```
claude
```
提问: 直接用自然语言描述你的需求，例如："解释一下这个项目的结构" 或 "帮我重构 main.py 文件"。
常用命令 :
- /help - 查看帮助。
- /exit - 退出程序。

常见问题

权限错误 : 如果在 WSL 中遇到 EACCES 错误，请加上 sudo 或修复 npm 权限。
安装错误: 如果进入claude之后提示进行native install，请尝试退出并运行'claude install' 重新安装。

如果遇到问题，欢迎沟通和交流！