Claude Code: Claude Code 安装与使用
最后更新：2026-08-31
安装 Claude Code 只需一条 npm 命令，但前提是你的环境已经就绪。本章从系统要求讲起，一步步带你完成安装和首次运行。
💡 提示：Claude Code 通过 npm 全局安装，需要 Node.js 18+ 环境。安装后通过
claude 命令启动。
📋 前置知识：第一章 Claude Code 简介与工作原理
1. 你将学到
- 系统要求与前置依赖
- npm 全局安装 Claude Code
- 首次运行与认证配置
- 基本使用流程
- 常见安装问题排查
2. 系统要求
(1) 硬件与软件要求
| 要求 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | macOS 12+ / Ubuntu 20.04+ / Windows 10+ | macOS 14+ / Ubuntu 22.04+ |
| Node.js | 18.x | 20.x+ |
| npm | 9.x | 10.x+ |
| 内存 | 4 GB | 8 GB+ |
| 网络 | HTTPS 出站 | 稳定低延迟 |
(2) 检查现有环境
BASH
# 检查 Node.js 版本
node --version
# 需要 v18+
# 检查 npm 版本
npm --version
# 需要 9+
# 如果没有 Node.js，使用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20
3. 安装 Claude Code
(1) npm 全局安装
BASH
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
# 输出类似：claude-code/1.0.x
(2) 替代安装方式
BASH
# 使用 npx 直接运行（无需全局安装）
npx @anthropic-ai/claude-code
# 从源码构建
git clone https://github.com/anthropics/claude-code.git
cd claude-code
npm install
npm run build
npm link
▶ 示例 1: 完整安装流程
BASH
# Alice 的完整安装过程
node --version # v20.11.0 ✓
npm --version # 10.2.4 ✓
# 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 验证
claude --version # claude-code/1.0.12 ✓
# 首次运行（会引导认证）
claude
# → Opening browser for authentication...
# → Authentication successful!
4. 首次运行与认证
(1) 认证方式
Claude Code 支持三种认证方式：
| 方式 | 适用场景 | 命令 |
|---|---|---|
| Anthropic 账号 | 个人用户 | claude（自动引导） |
| API Key | 企业/团队 | 设置环境变量 |
| OAuth | 企业 SSO | claude auth |
(2) API Key 配置
BASH
# 方式一：环境变量（推荐）
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
# 方式二：写入 shell 配置文件
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc
# 方式三：.env 文件
echo 'ANTHROPIC_API_KEY=sk-ant-api03-xxxxx' > .env
▶ 示例 2: 首次启动
BASH
$ claude
╭─────────────────────────────────────╮
│ Welcome to Claude Code! │
│ │
│ Let's get you set up. │
╰─────────────────────────────────────╯
? How would you like to authenticate?
❯ Anthropic Account (browser login)
API Key
OAuth (Enterprise)
# 选择 Anthropic Account 后：
# → Browser opens automatically
# → Login and authorize
# → "Authentication successful!"
5. 基本使用流程
(1) 在项目中启动
BASH
# 进入你的项目目录
cd ~/my-project
# 启动 Claude Code
claude
# 或直接带上任务
claude "帮我添加一个用户注册功能"
(2) 交互模式
TEXT
📖 仅展示
$ claude
╭─ Claude Code ─────────────────────────╮
│ Project: my-project │
│ Model: claude-sonnet-4-20250514 │
╰───────────────────────────────────────╯
> 帮我看看项目结构
Claude: Let me read the project structure...
- src/
- index.ts
- routes/
- utils/
- package.json
- tsconfig.json
> 修改 index.ts，添加健康检查接口
Claude: I'll add a health check endpoint...
→ Reading src/index.ts
→ Modifying src/index.ts
→ Running: npm run build ✓
6. 常见安装问题排查
▶ 示例 3: 问题排查清单
BASH
# 问题1：npm 安装权限错误
npm install -g @anthropic-ai/claude-code
# EACCES: permission denied
# 解决：
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
# 问题2：Node.js 版本过低
node --version # v16.x
# 解决：
nvm install 20
nvm use 20
# 问题3：网络超时
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
# 问题4：Windows 路径问题
# 确保 Node.js 安装路径在 PATH 中
where node
where claude
| 问题 | 原因 | 解决方案 |
|---|---|---|
command not found: claude |
PATH 未配置 | 检查 npm 全局安装路径 |
EACCES |
权限不足 | 使用 nvm 或修改 npm prefix |
ETIMEDOUT |
网络问题 | 切换镜像源 |
node_modules 错误 |
Node 版本低 | 升级到 Node 18+ |
| 认证失败 | API Key 无效 | 检查 Key 格式和额度 |
7. 综合示例：从零到运行
BASH
# 完整的安装到首次使用流程
# 1. 确认环境
node --version && npm --version
# 2. 安装
npm install -g @anthropic-ai/claude-code
# 3. 认证
export ANTHROPIC_API_KEY="sk-ant-api03-your-key"
# 4. 创建测试项目
mkdir hello-claude && cd hello-claude
git init
# 5. 首次运行
claude "创建一个 Express.js 的 Hello World 项目"
# Claude Code 输出：
# → Initializing project...
# → Creating package.json
# → Installing express
# → Creating index.js
# → Creating .gitignore
# → Running: node index.js
# → Server started on port 3000 ✓
❓ 常见问题
Q Windows 上能用 Claude Code 吗？
A 可以。通过 WSL2 或原生 Node.js 安装均可。推荐 WSL2 以获得最佳兼容性。
Q 安装需要 VPN 吗？
A 安装 npm 包通常不需要，但连接 Anthropic API 需要。API 端点在海外，网络不通则需要代理。
Q API Key 从哪里获取？
A 登录 console.anthropic.com，在 API Keys 页面创建。新账号有免费额度。
Q 可以离线安装吗？
A 安装需要网络，运行也需要网络（调 API）。暂无完全离线方案。
Q 卸载怎么做？
A
npm uninstall -g @anthropic-ai/claude-code 即可完全卸载。Q 如何更新？
A
npm update -g @anthropic-ai/claude-code 更新到最新版本。📖 小节
- Node.js 18+ 是前置要求，推荐使用 nvm 管理版本
npm install -g @anthropic-ai/claude-code一键安装- 支持三种认证方式：Anthropic 账号、API Key、OAuth
- 在项目目录下运行
claude即可启动 - 常见问题多与权限、版本、网络相关
📝 作业
- 基础题（难度⭐）：在你的机器上安装 Claude Code 并运行
claude --version，截图确认安装成功。 - 进阶题（难度⭐⭐）：配置 API Key 环境变量，在一个空目录中运行
claude，让它创建一个简单项目。 - 挑战题（难度⭐⭐⭐）：在 WSL2 环境中安装 Claude Code，对比原生 Windows 和 WSL2 的使用体验差异。
