Claude Code 新手教程：从安装到熟练使用的完整指南

终端里的 AI 编程助手，5 分钟上手，1 小时成为日常工具。

先说结论

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（macOS）：

brew install --cask claude-code

Windows：

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

WinGet（Windows）：

winget install Anthropic.ClaudeCode

注意：npm 安装方式已弃用，请使用上述官方推荐方式。

验证安装

claude --version

二、第一次使用

启动会话

cd ~/projects/my-app

claude

第一次启动会索引项目文件，可能需要几秒钟。

第一个任务

输入自然语言：

> 这个项目是做什么的？总结一下技术栈和目录结构。

Claude 会分析项目，给出回答。

第二个任务

> 在注册表单添加输入验证。邮箱需要验证格式，密码至少 8 个字符。

Claude 会： 1. 找到相关文件 2. 展示修改内容 3. 等你批准 4. 执行修改

三、常用命令

启动会话

最重要的三个命令： - /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

> 重构认证模块，从 session cookie 改成 JWT。

Claude 会： 1. 分析代码库 2. 制定方案 3. 展示推理过程 4. 等你批准

批准后才执行，避免"改错了再改回来"。

六、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 官方文档 — https://code.claude.com/docs

• Claude Code GitHub — https://github.com/anthropics/claude-code

• Claude Code Ultimate Guide — https://github.com/FlorianBruniaux/claude-code-ultimate-guide