Claude Code

Claude Code 新手入门手册

🚀 Claude Code 新手入门手册

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

目录

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

1. 什么是 Claude Code？

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

它能帮你做什么？

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

核心特点

2. 安装与环境配置

2.1 确认已安装的软件

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

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

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

安装 Git：

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

安装 Node.js：

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

安装 Python：

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

2.2 验证安装

打开 PowerShell，依次运行：

git --version
node --version
npm --version
python --version

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

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

3.1 创建你的第一个项目

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

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

在 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 的指引运行：

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: 几乎所有主流编程语言都支持，包括但不限于：

Q: 我的代码安全吗？

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

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

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

8. 练习项目推荐

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

初级 🌱

  1. TODO 清单（Python）

    • 命令行 TODO 应用
    • 练习：文件读写、数据结构

  2. 天气查询（JavaScript）

    • 调用免费天气 API
    • 练习：API 调用、异步编程

  3. 个人博客（HTML/CSS）

    • 静态个人页面
    • 练习：前端基础

中级 🌿

  1. REST API（Flask/FastAPI）

    • 用户 CRUD 接口
    • 练习：后端开发、数据库

  2. 浏览器游戏（JavaScript + Canvas）

    • 贪吃蛇或俄罗斯方块
    • 练习：游戏逻辑、事件处理

高级 🌳

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

快速参考卡片

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

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

最后的话

记住三条黄金法则：

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

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