🚀 Claude Code 2026中文教程指南-入门：Mac/Windows安装配置全攻略

📅 更新于 2026年5月 | ✍️ 原创文章，转载请注明出处

---

📌 目录

1. 什么是Claude Code
2. 核心特性与优势
3. 与其他AI编程工具对比
4. 系统要求
5. Mac安装配置
6. Windows安装配置
7. 首次使用与登录
8. 定价方案详解
9. 基本配置优化
10. 常见问题解答
11. 总结

---

1. 什么是Claude Code

Claude Code 是 Anthropic 于2025年推出的 终端原生AI编程助手。与传统的IDE插件不同，它直接运行在命令行中，能够：

• 🔍 理解整个代码库 — 自动读取项目文件，无需手动添加上下文
• ✏️ 自主编辑文件 — 跨文件重构、批量修改
• 🖥️ 执行终端命令 — 运行测试、安装依赖、Git操作
• 🤖 代理式编程 — 独立完成复杂任务，遇到问题会自己调试修复

简单说：它不是一个代码补全工具，而是一个能独立干活的AI程序员。

---

2. 核心特性与优势

🎯 核心能力

特性	说明
终端原生	直接在CLI运行，不依赖特定IDE
全项目理解	通过CLAUDE.md和文件扫描理解项目结构
自主执行	可独立完成多步骤任务（写代码→运行测试→修复bug）
Git集成	对话式Git操作，自动提交、创建PR
多平台支持	CLI、VS Code、JetBrains、桌面应用、Web界面
MCP协议	支持Model Context Protocol扩展能力
权限控制	修改文件前会请求确认，安全可控

💪 相比传统工具的优势

传统AI补全工具：
  你写一行 → AI补全一行 → 你确认

Claude Code：
  你说需求 → AI理解项目 → AI写完整功能 → AI跑测试 → AI修bug → 你review

---

3. 与其他AI编程工具对比

📊 2026年主流AI编程工具对比表

工具	类型	主要模型	价格（月）	最佳场景
Claude Code	终端CLI代理	Claude Opus 4/Sonnet 4	$20-200	复杂重构、自主任务
Cursor	AI原生IDE	多模型（Claude/GPT等）	$20	日常编码、快速迭代
GitHub Copilot	IDE插件	GPT-4o/Claude Sonnet	$10-19	代码补全、团队协作
Windsurf	AI原生IDE	多模型	$15	全栈开发
Hermes Agent	终端CLI代理	多模型可配	开源免费	个人助手、多平台
OpenClaw	CLI/Web多代理	多模型可配	开源免费	多代理协作

🤔 如何选择？

你的需求	推荐工具
复杂项目重构、跨文件修改	Claude Code
日常写代码、快速迭代	Cursor
团队协作、企业部署	GitHub Copilot
想要免费开源方案	Hermes Agent / OpenClaw
需要多模型切换	Cursor / Hermes Agent
终端重度用户	Claude Code / Hermes Agent

💡 小贴士：很多开发者会组合使用，比如用 Copilot 做代码补全 + Claude Code 做复杂任务。

---

4. 系统要求

📋 基本要求

项目	要求
终端	macOS Terminal、iTerm2、Windows Terminal、WSL等
项目	需要有一个代码项目目录
账户	Claude订阅（Pro/Max/Team/Enterprise）或API账户
网络	需要能访问 claude.ai（可能需要代理）

💻 Windows额外要求

• Git for Windows（推荐）— 用于Bash工具支持
• 如果没有Git，Claude Code会回退到PowerShell

---

5. Mac安装配置

方法一：官方安装脚本（推荐）✅

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

安装完成后，脚本会自动将 claude 命令添加到 PATH。

方法二：Homebrew安装

brew install claude-code

方法三：手动下载

1. 访问 https://claude.ai/download
2. 下载 macOS 版本
3. 解压后将 claude 移动到 /usr/local/bin/

✅ 验证安装

claude --version

如果显示版本号，说明安装成功。

🔧 首次配置

# 进入你的项目目录
cd /path/to/your/project

# 启动Claude Code
claude

首次运行会提示登录，按照屏幕指示完成即可。

---

6. Windows安装配置

方法一：PowerShell安装（推荐）✅

打开 PowerShell，运行：

irm https://claude.ai/install.ps1 | iex

方法二：CMD安装

打开命令提示符，运行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法三：WinGet安装

winget install Anthropic.ClaudeCode

方法四：WSL安装

如果你使用WSL，可以按Linux方式安装：

curl -fsSL https://claude.ai/install.sh | bash

⚠️ Windows注意事项

1. 推荐安装Git for Windows

   • 下载：https://git-scm.com/download/win
   • 安装后Claude Code可以使用Bash工具，体验更好

2. 路径问题

   • Windows路径使用反斜杠 \，Claude Code会自动处理
   • 项目路径建议不要包含中文或特殊字符

3. 权限问题

   • 如果遇到权限错误，以管理员身份运行PowerShell

✅ 验证安装

claude --version

---

7. 首次使用与登录

🚀 启动Claude Code

# 进入项目目录
cd /path/to/your/project

# 启动交互模式
claude

🔐 登录方式

Claude Code支持多种登录方式：

方式	说明	适用场景
Claude订阅	Pro/Max/Team/Enterprise	个人/团队使用
API账户	Console预付费	按量付费
云服务商	AWS Bedrock/GCP Vertex/Azure	企业部署

📝 首次使用流程

1. 运行 claude
2. 选择登录方式
3. 浏览器打开授权页面
4. 登录并授权
5. 返回终端，开始使用

🔄 切换账户

# 在Claude Code交互模式中
/login

💬 基本交互

# 启动后，直接用自然语言交流
> 帮我看看这个项目的主要结构
> 帮我写一个用户登录功能
> 这段代码有什么bug？

# 退出
exit
# 或按 Ctrl+D

---

8. 定价方案详解

💰 2026年Claude订阅方案

方案	价格	Claude Code使用时长	适合人群
Pro	$20/月	约45分钟-2小时/天	轻度使用者
Max (5x)	$100/月	约3-6小时/天	中度开发者
Max (20x)	$200/月	约12-15+小时/天	重度使用者
Team	$30/人/月	Pro级别用量	小团队
Enterprise	联系销售	定制	大企业

📊 API按量付费价格

如果使用API账户（Console），按token计费：

模型	输入价格	输出价格
Claude Sonnet 4	$3/百万token	$15/百万token
Claude Opus 4	$15/百万token	$75/百万token
Claude Haiku 3.5	$0.80/百万token	$4/百万token

💡 选择建议

使用场景	推荐方案	理由
偶尔用用、学习	Pro ($20)	足够日常学习
每天写代码	Max 5x ($100)	3-6小时够用
全职开发、重度使用	Max 20x ($200)	不用担心用量
团队协作	Team ($30/人)	统一管理
只是想试试	API按量付费	用多少付多少

---

9. 基本配置优化

📁 CLAUDE.md 文件

在项目根目录创建 CLAUDE.md 文件，告诉Claude Code你的项目信息：

# 项目说明

这是一个Spring Boot后端项目。

## 技术栈
- Java 21
- Spring Boot 3.3.5
- MyBatis-Plus
- MySQL
- Redis

## 常用命令
- 编译: mvn clean package -DskipTests
- 测试: mvn clean test
- 启动: mvn spring-boot:run

## 代码规范
- 使用构造器注入
- 日志用 @Slf4j
- 统一返回 ApiResponse<T>

⚙️ 权限配置

Claude Code默认会在修改文件前询问你。你可以配置自动允许某些操作：

# 在交互模式中
/permissions

🔧 常用配置命令

命令	说明
/help	显示帮助
/clear	清空对话历史
/login	切换账户
/permissions	配置权限
exit 或 Ctrl+D	退出

---

10. 常见问题解答

❓ 安装失败怎么办？

Q: curl命令报错

# 检查网络连接
ping claude.ai

# 如果需要代理
export https_proxy=http://your-proxy:port
curl -fsSL https://claude.ai/install.sh | bash

Q: Windows提示"无法加载脚本"

# 临时允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

❓ 登录问题

Q: 浏览器打不开授权页面

• 检查网络是否能访问 claude.ai
• 尝试使用代理
• 手动复制终端显示的URL到浏览器

Q: 提示"账户未订阅"

• 需要先在 claude.ai 订阅Pro/Max/Team/Enterprise
• 或者在 console.anthropic.com 充值API额度

❓ 使用问题

Q: Claude Code好像不理解我的项目

• 创建 CLAUDE.md 文件描述项目
• 确保在项目根目录运行 claude

Q: 修改文件时卡住

• 按 Ctrl+C 中断当前操作
• 检查文件是否被其他程序锁定

---

11. 总结

🎯 关键要点

1. Claude Code是终端原生的AI编程代理，不只是代码补全
2. 安装简单，Mac/Linux一条命令，Windows用PowerShell
3. 需要Claude订阅，Pro $20/月起
4. CLAUDE.md很重要，能让Claude更好理解你的项目
5. 适合复杂任务，简单补全用Cursor/Copilot更方便

📚 下一篇预告

第2篇：Claude Code命令大全：CLI指令速查手册

详细介绍所有命令、参数、快捷键，让你成为Claude Code高手！

---

📚 参考资料

1. Claude Code官方文档 - Anthropic官方
2. Claude Code快速入门 - Anthropic官方
3. Claude定价页面 - Anthropic官方
4. Claude Code GitHub - 官方仓库

---

💬 你在使用Claude Code吗？遇到过什么问题？欢迎评论区交流！

📌 关注我，获取更多AI编程工具教程！