Claude Code新手必学零基础教程：一步步从安装到熟练使用详细全面指南

先给个结论：Claude Code 是 Anthropic 推出的一款智能编程工具，跑在终端里，能理解你的整个代码库，然后用自然语言对话的方式帮你写代码。

它的核心能力很清晰：理解整个项目的代码结构、执行 Bash 命令、编辑文件、做 Git 操作，甚至还能联网搜索和抓取网页。而且不局限于终端，还支持 VS Code、JetBrains IDE 和 Chrome 扩展。

什么人适合用？日常写代码的开发者、需要重构遗留代码的人、快速理解陌生代码库的人，都会觉得顺手。但如果你指望完全自动化、不看代码就发布，或者不愿意审查 AI 的输出，那它可能不太适合你。

一、安装

系统要求

支持 macOS、Linux 或 Windows 11，需要 Claude Pro 订阅（$20/月）或更高版本，以及一个终端应用。

安装方式

macOS / Linux 用户直接跑一行命令：
curl -fsSL https://claude.ai/install.sh | bash

用 Homebrew 的用户：
brew install --cask claude-code

Windows 用户：
irm https://claude.ai/install.ps1 | iex
或者用 WinGet：
winget install Anthropic.ClaudeCode

验证安装

跑一下 claude --version，看到版本号就说明装好了。

二、第一次使用

启动会话

进入项目目录：
cd ~/projects/my-app
然后输入：
claude
第一次启动会索引项目文件，等几秒钟就好。

第一个任务

直接打自然语言：
> 这个项目是做什么的？总结一下技术栈和目录结构。
Claude 会分析项目，给你一个详细的回答。

第二个任务

> 在注册表单添加输入验证。邮箱需要验证格式，密码至少 8 个字符。
Claude 的操作流程是：先找到相关文件，然后展示要修改的内容，等你批准之后，才会执行修改。

三、常用命令

核心就几个命令：
- /plan — 复杂任务先规划
- /clear — 上下文太多时清理
- /help — 忘了命令就看它

四、核心概念

权限系统

这一点很重要：Claude Code 不会自动执行任何操作。每次修改文件、运行命令，都需要你亲自批准。批准之前一定要仔细看变更内容，尤其是你不熟悉的代码。

安全方面有几个建议：只在受信任的目录中使用，仅在沙箱环境下使用 --dangerously-skip-permissions 这个参数。

上下文管理

Claude Code 有 200K token 的上下文窗口。用久了它会“遗忘”之前的内容，所以该清理的时候别犹豫。

模型选择

切换模型很简单：
/model opus
/model sonnet
/model haiku

经验法则：80% 的时间用 sonnet，最难的 20% 切到 opus。

五、Plan Mode：复杂任务的保险

什么时候用

涉及多个文件的重构、不熟悉的代码库、需要了解影响范围的操作，这些场景下先用 Plan Mode 准没错。

怎么用

> /plan
> 重构认证模块，从 session cookie 改成 JWT。
Claude 会先分析代码库，然后制定方案、展示推理过程，等你批准之后再执行。这样能避免“改错了再改回来”的循环。

六、CLAUDE.md：项目配置文件

为什么需要

有了这个文件，Claude 从第一条提示开始就会遵循你的编码规范，省心不少。

放在哪里

项目根目录，文件名就叫 CLAUDE.md。

写什么

## 技术栈
- Next.js 14 + App Router
- TypeScript（严格模式）
- Tailwind CSS
- PostgreSQL + Prisma

## 编码规范
- 使用函数组件和 hooks
- 所有函数必须有 TypeScript 返回类型
- 使用命名导出，不用默认导出
- 新工具函数必须写测试

## 测试
- 运行测试：npm run test
- 单元测试用 Vitest

## Git
- 提交格式：feat()、fix()、refactor()
- 功能开发在新分支

好处

Claude 会严格遵守这些规范，不需要你每次提醒。

七、实用工作流

理解陌生代码库
> 这个项目是做什么的？核心模块有哪些？

调试性能问题
> 用户反馈仪表盘加载需要 15 秒。检查仪表盘页面的 API 调用，找出性能瓶颈。

添加新功能
> 添加深色模式切换。用户偏好存在 localStorage，页面加载时应用，不要有闪烁。

重构遗留代码
> /plan
> 这个文件用回调模式。重构成 async/await，保持外部 API 不变。

Git 工作流
> 创建新分支 feat/dark-mode，提交刚才的修改，打开 PR 并描述改动内容。

八、新手常见错误

1. 过早信任
Claude 生成的代码可能有逻辑错误。每个输出都要验证，尤其是边缘情况。

2. 忽略上下文压力
上下文超过 70%，Claude 开始“遗忘”。及时 /compact 或 /clear。

3. 提问太模糊
别说什么“把代码改好一点”。要说：“重构 processPayment 函数，处理 Stripe 支付失败的情况，指数退避重试最多 3 次。”

4. 不用 Plan Mode
复杂任务直接执行，改错了再改回来，浪费时间。先用 /plan。

5. 随意批准 MCP
MCP 能扩展 Claude Code 的能力，但风险也不小。批准前检查来源，别安装未知来源的 MCP。

九、安全须知

数据收集

Claude Code 会收集使用数据（代码接受/拒绝）、相关对话数据，以及通过 /bug 命令提交的用户反馈。隐私保护方面，敏感信息有有限的保留期限，对用户会话数据有受限访问，且不把反馈用于模型训练。

MCP 服务器风险

MCP（Model Context Protocol）可以扩展 Claude Code 的能力，但也带来风险。检查清单：来源验证（>50 stars，最近 30 天有提交）、权限检查（无 --dangerous-* 标志）、版本锁定（不用 "latest" 或 "main"）、哈希验证。

开始简单

别一开始就配置一堆东西。推荐顺序：
1. 第一阶段：基础配置 CLAUDE.md
2. 第二阶段：如需要，添加命令和 hooks
3. 第三阶段：如需要多上下文，添加 agents
4. 第四阶段：真正需要时，再添加 MCP 服务器

十、IDE 和 GitHub 集成

VS Code 集成

在 VS Code 中可以直接调用 Claude Code，不用切换到终端。

JetBrains IDE 集成

支持 IntelliJ、PyCharm、WebStorm 等 JetBrains 系列 IDE。

GitHub 集成

在 GitHub PR 或 Issue 中用 @claude 标签，让 Claude 帮你审查代码或回答问题。

Chrome 扩展

浏览器中也能使用 Claude Code 的能力。

十一、学习路径

第一天

1. 安装 Claude Code
2. 在小项目上试用
3. 创建第一个 CLAUDE.md
4. 学习 /plan 和 /clear

第一周

1. 在日常项目使用
2. 尝试不同类型的任务
3. 注意上下文管理
4. 习惯批准前审查变更

第一月

1. 配置 hooks 自动化常见任务
2. 创建自定义命令
3. 尝试 Agent Teams（如果你用 Opus）

参考

• Claude Code 官方文档
• Claude Code GitHub
• Claude Code Ultimate Guide