# Claude Code

# Claude Code 新手入门手册

# 🚀 Claude Code 新手入门手册

> 欢迎！这是一份为你——完全零基础的新手——准备的完整指南。
> 不用害怕，我会一步一步带你走。

---

## 目录

1. [什么是 Claude Code？](#1-什么是-claude-code)
2. [安装与环境配置](#2-安装与环境配置)
3. [第一个项目：从零开始](#3-第一个项目从零开始)
4. [核心功能速览](#4-核心功能速览)
5. [常用操作示例](#5-常用操作示例)
6. [高级技巧](#6-高级技巧)
7. [常见问题 FAQ](#7-常见问题-faq)
8. [练习项目推荐](#8-练习项目推荐)

---

## 1. 什么是 Claude Code？

**Claude Code** 是一个运行在终端里的 AI 编程助手。你可以用自然语言（就像现在这样聊天）告诉它你想做什么，它会帮你完成。

### 它能帮你做什么？

| 能力 | 举例 |
|------|------|
| **写代码** | "帮我写一个 Python 计算器" |
| **读代码** | "这段代码是什么意思？" |
| **调试** | "这个报错是怎么回事？" |
| **重构** | "让这段代码更简洁" |
| **解释概念** | "什么是 REST API？" |
| **生成测试** | "给这个函数写单元测试" |
| **项目管理** | "初始化一个 Node.js 项目" |

### 核心特点

- **对话式**：像和朋友聊天一样工作
- **直接操作文件**：它可以直接创建、修改、读取你的代码文件
- **执行命令**：可以帮你运行 npm install、python 等命令
- **理解整个项目**：它能浏览你的整个代码库

---

## 2. 安装与环境配置

### 2.1 确认已安装的软件

你电脑上已经安装了以下开发工具：

```
✅ Node.js & npm  —— 用于运行 JavaScript/Node.js 项目
✅ Python 3.14    —— 用于运行 Python 项目
✅ Git            —— 版本控制工具
```

如果缺少某个工具，可以用以下命令安装：

**安装 Git：**
```powershell
# 从 https://git-scm.com/download/win 下载安装
# 或使用 winget（如果你有的话）
winget install Git.Git
```

**安装 Node.js：**
```powershell
# 从 https://nodejs.org 下载安装（推荐 LTS 版本）
# 或
winget install OpenJS.NodeJS.LTS
```

**安装 Python：**
```powershell
# 从 https://www.python.org/downloads/ 下载安装
# 或
winget install Python.Python.312
```

### 2.2 验证安装

打开 PowerShell，依次运行：

```powershell
git --version
node --version
npm --version
python --version
```

看到版本号就说明安装成功！

---

## 3. 第一个项目：从零开始

### 3.1 创建你的第一个项目

我们创建一个简单的 Python 网页应用来练手。

**步骤 1：在项目目录中初始化**

在 PowerShell 中运行：

```powershell
cd D:\code
mkdir my-first-project
cd my-first-project
```

**步骤 2：告诉 Claude Code 帮你搭建项目**

在 Claude Code 的提示符下输入：

```
帮我初始化一个 Python Flask 项目，包含一个首页和一个关于页面
```

Claude Code 会：
1. 自动创建项目结构
2. 安装必要的依赖
3. 编写代码文件
4. 告诉你如何运行

**步骤 3：运行项目**

按照 Claude Code 的指引运行：

```powershell
pip install flask
python app.py
```

然后打开浏览器访问 `http://localhost:5000` 就能看到你的第一个网页！

---

## 4. 核心功能速览

### 4.1 基本对话模式

这是最基础的用法——直接聊天。

```
你：帮我写一个 Python 列表去重的函数
Claude：当然！这是实现...
你：能不能加个类型注解？
Claude：好的，改成这样...
```

**关键技巧：**
- 直接说人话，不需要特殊语法
- 可以连续追问，逐步完善
- 不满意就说"换一种方式"

### 4.2 文件操作

Claude Code 可以直接读写文件，不需要你手动编辑。

```
你：在 src/ 目录下创建一个 utils.py 文件，
    里面写一个计算斐波那契数列的函数
```

它会自动创建文件并写好代码。

### 4.3 代码搜索

```
你：搜索整个项目中所有用到 requests 的地方
```

它会列出所有匹配的文件和行号。

### 4.4 错误调试

```
你：我运行这段代码报错了，帮我看看为什么
    （粘贴错误信息）
```

它会分析错误原因并提供修复方案。

---

## 5. 常用操作示例

以下是你最可能用到的场景，直接复制就能用：

### 📝 创建新项目

```
在 D:\code\my-app 目录下初始化一个 React 项目
```

### 💻 写代码

```
写一个 Python 脚本，读取 CSV 文件并统计每列的平均值
```

### 🔍 理解代码

```
解释一下 src/main.py 这个文件在做什么
```

### 🐛 修复 Bug

```
这个函数有 bug，用户输入负数时会出错，帮我修复
```

### ✨ 优化代码

```
让这段代码更高效，最好加上注释
```

### 🧪 生成测试

```
给 auth.py 里的登录函数写单元测试
```

### 📦 管理依赖

```
查看 package.json 里有哪些过时的包
```

### 🔄 重构代码

```
把这个 200 行的函数拆分成几个小函数
```

---

## 6. 高级技巧

### 6.1 上下文保持

Claude Code 会记住当前的对话上下文。你可以：

```
你：写一个排序函数
Claude：好的，这是冒泡排序...
你：换成快速排序
Claude：没问题...
你：再加个时间复杂度分析
```

三步连贯操作，不需要重复背景信息。

### 6.2 多文件协作

```
你：修改 user.py 中的用户名验证逻辑，
    同时更新 test_user.py 中的对应测试
```

它可以跨文件协同修改。

### 6.3 批量操作

```
你：把所有 print() 语句替换成 logging 模块
```

它会遍历整个项目，逐一修改。

### 6.4 交互式提问

当你不确定怎么做时，Claude Code 可能会反问：

```
Claude：你想要哪种数据库？MySQL 还是 PostgreSQL？
```

直接回答即可，它会继续工作。

---

## 7. 常见问题 FAQ

### Q: 我该怎么向你提问？

**A:** 就像跟朋友聊天一样自然就好！

- ✅ "帮我写一个..."
- ✅ "这个是什么意思？"
- ✅ "怎么修复这个错误？"
- ✅ "有没有更好的写法？"

### Q: 你说"不确定的时候怎么办？

**A:** 直接说"我不确定"，然后告诉我你已知的所有信息。我会尽力帮忙。

### Q: 我能一次问多个问题吗？

**A:** 建议一次聚焦一个问题。复杂任务可以拆分成多个步骤，逐步完成。

### Q: 你支持哪些编程语言？

**A:** 几乎所有主流编程语言都支持，包括但不限于：
- Python、JavaScript/TypeScript
- Java、C++、Go、Rust
- Ruby、PHP、Swift、Kotlin
- SQL、HTML/CSS
- 甚至 Bash、Markdown 等脚本语言

### Q: 我的代码安全吗？

**A:** 是的。你的代码只用于辅助理解上下文，不会被存储或分享给其他人。

### Q: 如果我说的不清楚怎么办？

**A:** 我会反问澄清，或者给出几种可能的方案让你选择。

---

## 8. 练习项目推荐

按照以下顺序练习，循序渐进：

### 初级 🌱

1. **TODO 清单**（Python）
   - 命令行 TODO 应用
   - 练习：文件读写、数据结构

2. **天气查询**（JavaScript）
   - 调用免费天气 API
   - 练习：API 调用、异步编程

3. **个人博客**（HTML/CSS）
   - 静态个人页面
   - 练习：前端基础

### 中级 🌿

4. **REST API**（Flask/FastAPI）
   - 用户 CRUD 接口
   - 练习：后端开发、数据库

5. **浏览器游戏**（JavaScript + Canvas）
   - 贪吃蛇或俄罗斯方块
   - 练习：游戏逻辑、事件处理

### 高级 🌳

6. **全栈应用**
   - 带前端的完整 Web 应用
   - 练习：前后端协作、部署

---

## 快速参考卡片

把这张卡片存下来，随时查阅：

```
┌─────────────────────────────────────────────┐
│           Claude Code 常用指令               │
├─────────────────────────────────────────────┤
│  写代码：    "帮我写一个 XXX"                 │
│  读代码：    "解释一下 XXX 文件"              │
│  找代码：    "搜索所有用到 XXX 的地方"         │
│  修Bug：     "这段代码报错了，帮我看看"        │
│  优化：      "让 XXX 更简洁/高效"             │
│  测试：      "给 XXX 写单元测试"              │
│  翻译：      "把这段代码转成 XXX 语言"         │
│  生成文档：  "给这个项目写 README"            │
│  删代码：    "删除 XXX 文件和相关内容"         │
│  学概念：    "什么是 XXX？用简单的话解释"      │
└─────────────────────────────────────────────┘
```

---

## 最后的话

记住三条黄金法则：

1. **大胆问**：没有"愚蠢的问题"，问就对了
2. **多迭代**：第一次不满意就让我改，改到满意为止
3. **保持好奇**：每段代码都是学习的机会

---

*祝你和 Claude Code 合作愉快！有任何问题随时问我 😊*