文章目录
- 特性 说明 终端原生 直接在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
- 工具 类型 主要模型 价格（月） 最佳场景 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 做复杂任务。
- # 一键安装 curl -fsSL https://claude.ai/install.sh | bash 安装完成后，脚本会自动将 claude 命令添加到 PATH。
- brew install claude-code
- 访问 https://claude.ai/download 下载 macOS 版本 解压后将 claude 移动到 /usr/local/bin/ 验证安装 claude –version 如果显示版本号，说明安装成功。 首次配置 # 进入你的项目目录 cd /path/to/your/project # 启动Claude Code claude 首次运行会提示登录，按照屏幕指示完成即可。
- 打开 PowerShell，运行： irm https://claude.ai/install.ps1 | iex
- 打开命令提示符，运行： curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
- winget install Anthropic.ClaudeCode
- 如果你使用WSL，可以按Linux方式安装： curl -fsSL https://claude.ai/install.sh | bash Windows注意事项 推荐安装Git for Windows 下载：https://git-scm.com/download/win 安装后Claude Code可以使用Bash工具，体验更好 路径问题 Windows路径使用反斜杠 ，Claude Code会自动处理 项目路径建议不要包含中文或特殊字符 权限问题 如果遇到权限错误，以管理员身份运行PowerShell 验证安装 claude –version
- # 进入项目目录 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
- 方案 价格 Claude Code使用时长 适合人群 Pro $20/月 约45分钟-2小时/天 轻度使用者 Max (5x) $100/月 约3-6小时/天 中度开发者 Max (20x) $200/月 约12-15+小时/天 重度使用者 Team $30/人/月 Pro级别用量 小团队 Enterprise 联系销售 定制 大企业
- 如果使用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按量付费 用多少付多少
- 在项目根目录创建 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 退出
- 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 中断当前操作 检查文件是否被其他程序锁定
目录
- 1. 什么是Claude Code
- 2. 核心特性与优势
- 核心能力
- 相比传统工具的优势
- 3. 与其他AI编程工具对比
- 2026年主流AI编程工具对比表
- 如何选择？
- 4. 系统要求
- 基本要求
- Windows额外要求
- 5. Mac安装配置
- 方法一：官方安装脚本（推荐）
- 方法二：Homebrew安装
- 方法三：手动下载
- 6. Windows安装配置
- 方法一：PowerShell安装（推荐）
- 方法二：CMD安装
- 方法三：WinGet安装
- 方法四：WSL安装
- 7. 首次使用与登录
- 启动Claude Code
- 登录方式
- 首次使用流程
- 切换账户
- 基本交互
- 8. 定价方案详解
- 2026年Claude订阅方案
- API按量付费价格
- 选择建议
- 9. 基本配置优化
- CLAUDE.md 文件
- 权限配置
- 常用配置命令
- 10. 常见问题解答
- 安装失败怎么办？
- 登录问题
- 使用问题
- 11. 总结
Claude Code 是 Anthropic 于2025年推出的 终端原生AI编程助手。与传统的IDE插件不同，它直接运行在命令行中，能够：
- 理解整个代码库 — 自动读取项目文件，无需手动添加上下文
- 自主编辑文件 — 跨文件重构、批量修改
- 执行终端命令 — 运行测试、安装依赖、Git操作
- 代理式编程 — 独立完成复杂任务，遇到问题会自己调试修复
简单说：它不是一个代码补全工具，而是一个能独立干活的AI程序员。
| 特性 | 说明 |
|---|---|
| 终端原生 | 直接在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
| 工具 | 类型 | 主要模型 | 价格（月） | 最佳场景 |
|---|---|---|---|---|
| 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 做复杂任务。
| 项目 | 要求 |
|---|---|
| 终端 | macOS Terminal、iTerm2、Windows Terminal、WSL等 |
| 项目 | 需要有一个代码项目目录 |
| 账户 | Claude订阅（Pro/Max/Team/Enterprise）或API账户 |
| 网络 | 需要能访问 claude.ai（可能需要代理） |
- Git for Windows（推荐）— 用于Bash工具支持
- 如果没有Git，Claude Code会回退到PowerShell
# 一键安装
curl -fsSL https://claude.ai/install.sh | bash
安装完成后，脚本会自动将 claude 命令添加到 PATH。
brew install claude-code
- 访问 https://claude.ai/download
- 下载 macOS 版本
- 解压后将
claude 移动到 /usr/local/bin/
claude 移动到 /usr/local/bin/验证安装
claude --version
如果显示版本号，说明安装成功。
首次配置
# 进入你的项目目录 cd /path/to/your/project # 启动Claude Code claude
首次运行会提示登录，按照屏幕指示完成即可。
打开 PowerShell，运行：
irm https://claude.ai/install.ps1 | iex
打开命令提示符，运行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
winget install Anthropic.ClaudeCode
如果你使用WSL，可以按Linux方式安装：
curl -fsSL https://claude.ai/install.sh | bash
Windows注意事项
-
推荐安装Git for Windows
- 下载：https://git-scm.com/download/win
- 安装后Claude Code可以使用Bash工具，体验更好
-
路径问题
- Windows路径使用反斜杠
，Claude Code会自动处理 - 项目路径建议不要包含中文或特殊字符
- Windows路径使用反斜杠
-
权限问题
- 如果遇到权限错误，以管理员身份运行PowerShell
验证安装
claude --version
# 进入项目目录
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
| 方案 | 价格 | Claude Code使用时长 | 适合人群 |
|---|---|---|---|
| Pro | $20/月 | 约45分钟-2小时/天 | 轻度使用者 |
| Max (5x) | $100/月 | 约3-6小时/天 | 中度开发者 |
| Max (20x) | $200/月 | 约12-15+小时/天 | 重度使用者 |
| Team | $30/人/月 | Pro级别用量 | 小团队 |
| Enterprise | 联系销售 | 定制 | 大企业 |
如果使用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按量付费 | 用多少付多少 |
在项目根目录创建 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 |
退出 |
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中断当前操作 - 检查文件是否被其他程序锁定
- Claude Code是终端原生的AI编程代理，不只是代码补全
- 安装简单，Mac/Linux一条命令，Windows用PowerShell
- 需要Claude订阅，Pro $20/月起
- CLAUDE.md很重要，能让Claude更好理解你的项目
- 适合复杂任务，简单补全用Cursor/Copilot更方便
以上就是2026年Claude Code中文教程指南入门:Mac/Windows安装配置全攻略的详细内容，更多关于Claude Code安装配置的资料请关注风君子博客其它相关文章！