Claude Code 安装教程

DC大锅2026-06-11 9:58

适用对象 ：全新电脑（Windows / macOS / Linux） 最后更新 ：2026-06-10 当前版本：v2.1.x（Claude Sonnet 4.6 / Opus 4.6）

目录

一、什么是 Claude Code

css 复制代码 
┌─────────────────────────────────────────────────────────┐
│                     Claude Code                          │
│                                                         │
│  终端 AI 编程助手，运行在命令行中                          │
│                                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐              │
│  │ 理解代码库 │  │ 编写代码  │  │ Git 操作  │              │
│  └──────────┘  └──────────┘  └──────────┘              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐              │
│  │ 调试 Bug  │  │ 代码重构  │  │ 自动测试  │              │
│  └──────────┘  └──────────┘  └──────────┘              │
│                                                         │
│  通过自然语言与 AI 对话，完成以上所有操作                    │
└─────────────────────────────────────────────────────────┘

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手。它可以直接在命令行中运行，理解你的整个代码库，你只需要用自然语言描述需求，它就能帮你完成编码、调试、重构、Git 工作流等各种软件工程任务。

二、系统要求

2.1 硬件要求

项目 最低要求 推荐配置
内存 4 GB 8 GB 及以上
磁盘空间 500 MB 2 GB 及以上
网络 宽带连接 稳定宽带

2.2 软件要求

项目 最低版本 推荐版本
操作系统 Windows 10 / macOS 10.15 / Ubuntu 20.04 Windows 11 / macOS 14+ / Ubuntu 24.04
Node.js 18.0+ 20 LTS 或 22 LTS
Git 2.23+（可选但推荐） 最新稳定版
终端 系统自带 Windows Terminal / iTerm2 / Warp

2.3 架构支持

scss 复制代码 
x86_64 / amd64 ...... ✅ 全平台支持
ARM64 / aarch64 ..... ✅ 全平台支持 (Apple Silicon / Windows ARM)

三、前置依赖安装

3.1 安装 Node.js（必须）

Claude Code 依赖 Node.js 运行时，必须先安装。

🪟 Windows

arduino 复制代码 
📥 下载地址：https://nodejs.org
   选择 LTS 版本 (推荐 v20.x 或 v22.x)

安装步骤：
┌──────────────────────────────────────┐
│ 1. 下载 .msi 安装包                  │
│ 2. 双击运行，点击 Next               │
│ 3. ☑ 勾选 "Automatically install    │
│       the necessary tools"           │
│ 4. ☑ 确保 "Add to PATH" 已勾选      │
│ 5. 点击 Install，等待完成            │
│ 6. 重启终端                          │
└──────────────────────────────────────┘

验证安装：

powershell 复制代码 
node --version    # 应输出 v20.x.x 或 v22.x.x
npm --version     # 应输出 10.x.x 或以上

🍎 macOS

bash 复制代码 
# 方式一：官网下载（推荐初学者）
# 访问 https://nodejs.org → 下载 macOS LTS 版本 .pkg → 双击安装

# 方式二：Homebrew（推荐开发者）
brew install node@20

# 验证
node --version
npm --version

🐧 Linux (Ubuntu/Debian)

bash 复制代码 
# 使用 NodeSource 官方源安装 Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version
npm --version

🐧 Linux (CentOS/RHEL/Fedora)

bash 复制代码 
# 使用 NodeSource 官方源
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs    # Fedora
# 或
sudo yum install -y nodejs    # CentOS/RHEL

3.2 安装 Git（推荐）

Git 不是必须的，但强烈建议安装，以便 Claude Code 操作版本控制。

平台 安装方式
Windows 下载：git-scm.com/downloads/w... → 运行 .exe，一路默认即可
macOS brew install git 或下载 git-scm.com/downloads/m...
Linux sudo apt install git (Debian/Ubuntu) 或 sudo dnf install git (Fedora)

验证：

bash 复制代码 
git --version    # 应输出 git version 2.xx.x

四、安装 Claude Code

安装方式总览

markdown 复制代码 
                    选择你的平台
                        │
        ┌───────────────┼───────────────┐
        ▼               ▼               ▼
    🪟 Windows      🍎 macOS        🐧 Linux
        │               │               │
        ├─ 官方脚本      ├─ 官方脚本      ├─ 官方脚本
        ├─ WinGet        ├─ Homebrew     └─ npm（通用）
        └─ npm（通用）    └─ npm（通用）

🍎 macOS

bash 复制代码 
# ⭐ 方式一：官方安装脚本（推荐，一键安装）
curl -fsSL https://claude.ai/install.sh | bash

# 方式二：Homebrew Cask
brew install --cask claude-code

# 方式三：安装最新版本
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 方式四：安装指定版本（如需锁定版本）
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.7

🪟 Windows

powershell 复制代码 
# ⭐ 方式一：PowerShell 官方脚本（推荐）
irm https://claude.ai/install.ps1 | iex

# 方式二：WinGet 包管理器
winget install Anthropic.ClaudeCode

# 方式三：CMD 命令行
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

⚠️ 安全策略问题？ 如果 PowerShell 报 execution of scripts is disabled 错误：

powershell 复制代码 
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

然后重新运行安装命令。

🐧 Linux

bash 复制代码 
# ⭐ 方式一：官方安装脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# 方式二：安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.7

# 注意：如果权限不够，加上 sudo
curl -fsSL https://claude.ai/install.sh | sudo bash

🌐 通用方式：npm（全平台适用）

bash 复制代码 
npm install -g @anthropic-ai/claude-code

⚠️ 注意 ：npm 方式已被官方标记为弃用 (Deprecated)，推荐使用上面的原生安装脚本。npm 方式仅在脚本不可用时的备选。

五、验证安装

安装完成后，新开一个终端窗口，运行：

bash 复制代码 
claude --version

如果输出类似以下内容，说明安装成功：

css 复制代码 
Claude Code v2.1.7

也可以运行帮助命令确认所有功能可用：

bash 复制代码 
claude --help

六、首次启动与认证

6.1 认证流程

复制代码 
┌─────────────────────────────────────────────────────┐
│                                                     │
│   ① 终端运行 claude                                  │
│         │                                           │
│         ▼                                           │
│   ② 终端显示一次性验证链接 + 验证码                    │
│         │                                           │
│         ▼                                           │
│   ③ 浏览器打开链接，输入验证码                         │
│         │                                           │
│         ▼                                           │
│   ④ 登录 Claude 账号，授权终端                        │
│         │                                           │
│         ▼                                           │
│   ⑤ 终端自动进入交互模式 ✅                           │
│                                                     │
└─────────────────────────────────────────────────────┘

6.2 详细步骤

步骤一：进入项目目录

bash 复制代码 
cd /path/to/your-project

步骤二：启动 Claude Code

bash 复制代码 
claude

步骤三：完成浏览器认证

首次运行时，终端会显示类似：

ini 复制代码 
Please authenticate in your browser:

  https://claude.ai/activate?code=XXXX-XXXX

  Your one-time code: XXXX-XXXX
  1. 复制链接在浏览器中打开
  2. 输入终端显示的验证码
  3. 登录你的 Anthropic / Claude 账号
  4. 页面显示 "Authentication Successful" 即可

步骤四：回到终端

认证完成后的效果：

css 复制代码 
✓ Authenticated successfully
✓ Loading project context...

  Hello! I'm Claude Code. How can I help you today?

>

现在你可以直接用自然语言与 Claude Code 对话了：

shell 复制代码 
> 帮我分析一下这个项目的目录结构
> 修复 src/utils.js 里的 bug
> 为这个函数写单元测试

6.3 使用 API Key 认证（替代方式）

如果你有 Anthropic API Key，可以跳过浏览器认证：

macOS / Linux：

bash 复制代码 
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Windows PowerShell：

powershell 复制代码 
$env:ANTHROPIC_API_KEY = "sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

建议将上述环境变量写入 .bashrc、.zshrc 或 Windows 系统环境变量中，避免每次手动设置。

七、账号要求

账号类型 月费 适用场景
Claude Free 免费 轻度体验，额度极少
Claude Pro $20 个人开发者日常使用
Claude Max 100/100 / 100/200 重度用户，不限次数
Claude Team $25/席位 团队协作
Claude Enterprise 联系销售 企业级部署
API Key 按量计费 灵活付费，适合已有 API 账号的用户

💡 建议 ：个人开发者选择 Claude Pro（$20/月） 即可满足大部分需求。

八、常用配置

8.1 项目级配置：CLAUDE.md

在项目根目录创建 CLAUDE.md，Claude Code 每次启动时会自动读取：

markdown 复制代码 
# 项目名称

## 技术栈
- React 18 + TypeScript
- Node.js 后端

## 编码规范
- 使用 ESLint + Prettier
- 提交信息遵循 Conventional Commits

## 目录结构
- src/ : 源代码
- tests/ : 测试文件
- docs/ : 文档

8.2 全局配置文件

配置文件位置：~/.claude/settings.json

json 复制代码 
{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "autoUpdate": false
}

8.3 环境变量

bash 复制代码 
# 关闭自动更新
export DISABLE_AUTOUPDATER=1

# 指定默认模型
export CLAUDE_MODEL=claude-sonnet-4-6

# 设置 API Key
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

8.4 手动更新

bash 复制代码 
claude update

九、日常使用流程

ini 复制代码 
┌──────────────────────────────────────────────┐
│                                              │
│   cd my-project          # 进入项目目录       │
│        │                                     │
│   claude                 # 启动 Claude Code   │
│        │                                     │
│   > 帮我把登录接口加上参数校验                  │
│        │                                     │
│   [Claude Code 分析代码 → 编写修改 → 展示 diff] │
│        │                                     │
│   确认 / 拒绝修改                             │
│        │                                     │
│   > 提交代码                                 │
│        │                                     │
│   [Claude Code 自动 git add → commit]         │
│                                              │
└──────────────────────────────────────────────┘

常用命令

命令 说明
/help 查看帮助
/clear 清空对话历史
/compact 压缩上下文（节省 Token）
/doctor 诊断环境问题
/cost 查看当前会话费用
/init 为项目生成 CLAUDE.md
Ctrl + C 退出 Claude Code

十、常见问题排查

10.1 claude 命令找不到

markdown 复制代码 
📌 原因：安装路径未加入 PATH 环境变量
🔧 解决：
   1. 关闭终端，重新打开
   2. Windows 用户可以重启电脑
   3. 检查 npm 全局安装路径是否在 PATH 中

10.2 认证失败 / 超时

markdown 复制代码 
📌 原因：网络问题或防火墙拦截
🔧 解决：
   1. 确认网络能访问 claude.ai
   2. 关闭代理 / VPN 后重试
   3. 尝试使用 API Key 方式认证
   4. 在公司网络？检查是否屏蔽了认证域名

10.3 Node.js 版本过低

markdown 复制代码 
📌 原因：Node.js < 18.0
🔧 解决：
   1. 运行 node --version 确认版本
   2. 如低于 18，按照前面 3.1 节升级 Node.js

10.4 Windows 脚本无法执行

sql 复制代码 
📌 原因：PowerShell 执行策略限制
🔧 解决：
   以管理员身份运行 PowerShell，执行：
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

10.5 Linux/macOS 权限不足

bash 复制代码 
📌 原因：全局安装需要写系统目录的权限
🔧 解决：
   方式一：npm install -g 前加 sudo
   方式二（推荐）：使用 nvm 管理 Node.js，避免权限问题
       curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

10.6 Git 未配置用户名和邮箱

arduino 复制代码 
📌 原因：Git 首次使用需要设置身份
🔧 解决：
   git config --global user.name "你的名字"
   git config --global user.email "your@email.com"

十一、资源链接汇总

官方资源

资源 地址
📖 Claude Code 官方文档 code.claude.com/docs/en/ove...
🔧 安装指南 code.claude.com/docs/en/set...
📦 GitHub 仓库 github.com/anthropics/...
🌐 Claude 官网 claude.ai
🔑 Anthropic 控制台（API Key） console.anthropic.com
❓ 帮助中心 support.claude.com

依赖下载

资源 地址
📥 Node.js 下载 nodejs.org
📥 Git 下载 git-scm.com/downloads
📥 Windows Terminal aka.ms/terminal (Microsoft Store)

推荐终端工具

工具 平台 特点
Windows Terminal Windows 微软官方，支持多标签、GPU 加速
iTerm2 macOS 老牌强大终端，分屏功能出色
Warp macOS / Linux AI 加持的现代终端
Hyper 全平台 基于 Electron，高度可定制

附录：一键安装脚本集合

macOS 全自动安装

bash 复制代码 
#!/bin/bash
# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install node@20 git

# 安装 Claude Code
brew install --cask claude-code

echo "✅ 安装完成！运行 claude 开始使用。"

Windows 全自动安装（PowerShell）

powershell 复制代码 
# 安装 Winget 包（如未安装，Windows 11 自带）
# 然后执行：

winget install OpenJS.NodeJS.LTS
winget install Git.Git
winget install Anthropic.ClaudeCode

Write-Host "✅ 安装完成！新开终端后运行 claude 开始使用。" -ForegroundColor Green

Linux (Ubuntu) 全自动安装

bash 复制代码 
#!/bin/bash
# 安装 Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 Git
sudo apt-get install -y git

# 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash

echo "✅ 安装完成！运行 claude 开始使用。"

祝你使用愉快！有任何问题可以查阅官方文档或在终端中运行 /help 获取帮助。

相关推荐
AI原来如此2 小时前
Claude Opus与GPT-5激战，国内API中转站如何应对2026模型迭代潮？
大数据·人工智能·gpt·ai·大模型·ai编程
码农阿强3 小时前
Claude-Fable-5 技术详解 + 基于 startapi.top 接口实战调用（附多语言代码示例）
人工智能·gpt·ai·aigc·ai编程
雨季mo浅忆3 小时前
Cursor快速实现上传Excel功能
前端·vue3·ai编程
财经资讯数据_灵砚智能3 小时前
基于全球经济类多源新闻的NLP情感分析与数据可视化（夜间-次晨）2026年6月9日
人工智能·python·ai·信息可视化·自然语言处理·ai编程·灵砚智能
唐某人丶11 小时前
模型越来越强，我们还需要 Agent 工程吗？—— 从价值重估到 Harness 实践
前端·agent·ai编程
程序员黑豆17 小时前
AI全栈开发之Java：怎么配置Java环境变量
前端·后端·ai编程
蓝晶之心17 小时前
cursor初学实战项目——待办清单
ai编程
孟健18 小时前
我把 Claude Code 切到 Fable 5，先别急着兴奋
ai编程
热门推荐
01《置身钉内》原文-可播放阅读02【AI】2026 年具身智能模型和世界模型总结03GitHub 镜像站点042026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？05Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析062026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf07Codex 下载安装指南：Windows 和 macOS 官方版下载08AI科技热点日报 | 2026年6月1日09【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法10CC-Switch 下载、安装与使用配置指南【2026.5.29】