# 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**：
```bash
curl -fsSL https://claude.ai/install.sh | bash
```

**Homebrew（macOS）**：
```bash
brew install --cask claude-code
```

**Windows**：
```powershell
irm https://claude.ai/install.ps1 | iex
```

**WinGet（Windows）**：
```bash
winget install Anthropic.ClaudeCode
```

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

### 验证安装

```bash
claude --version
```

---

## 二、第一次使用

### 启动会话

```bash
cd ~/projects/my-app
claude
```

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

### 第一个任务

输入自然语言：
```
> 这个项目是做什么的？总结一下技术栈和目录结构。
```

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

### 第二个任务

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

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

---

## 三、常用命令

| 命令 | 作用 |
|------|------|
| `claude` | 启动会话 |
| `/help` | 显示所有命令 |
| `/plan` | 先规划再执行 |
| `/clear` | 清除上下文，重新开始 |
| `/cost` | 查看 token 用量和费用 |
| `/compact` | 压缩对话历史 |
| `/model` | 切换模型 |

**最重要的三个命令**：
- `/plan` — 复杂任务先规划
- `/clear` — 上下文太多时清理
- `/help` — 忘了命令就看它

---

## 四、核心概念

### 权限系统

Claude Code 不会自动执行任何操作。每次文件修改、命令运行，都需要你批准。

批准前仔细看变更，尤其是不熟悉的代码。

**安全建议**：
- 在受信任的目录中使用
- 仅在沙箱环境中使用 `--dangerously-skip-permissions`

### 上下文管理

Claude Code 有 200K token 的上下文窗口。用多了会"遗忘"之前的内容。

| 上下文使用 | 建议 |
|-----------|------|
| 0-50% | 自由工作 |
| 50-70% | 准备压缩 |
| 70-90% | 立即运行 `/compact` |
| 90%+ | 必须运行 `/clear` |

### 模型选择

| 模型 | 速度 | 适用场景 |
|------|------|---------|
| haiku | 最快 | 简单任务、快速响应 |
| sonnet | 平衡 | 大部分日常任务 |
| opus | 最强 | 复杂架构、多文件重构 |

**切换模型**：
```bash
/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`。

### 写什么

```markdown
# 项目：我的 SaaS 应用

## 技术栈
- 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

Claude Code 是 Anthropic 推出的智能编程工具。它运行在终端中，理解你的代码库，通过自然语言命令帮助你编码。

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

软件研发

开发工具

编程语言

人工智能

ClaudeCode是Anthropic推出的智能编程助手，支持终端操作、代码理解与编辑。本教程涵盖安装步骤、核心功能、常用命令和安全建议，帮助开发者快速上手。包含VSCode/JetBrains集成、GitHub协作和进阶学习路径，适合需要提升编码效率的程序员。

单元测试

PostgreSQL

TypeScript

服务器

WebStorm

Windows

GitHub

Linux

SaaS

4核4G3M云服务器 新用户低至38元/年！

2026采购季 | AI焕新·智启新局

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 新手教程：从安装到熟练使用的完整指南-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐