交互式教程 · v1.0

Claude Code 快速入门

从零开始掌握 Claude Code 的核心功能,附带交互测验帮你巩固。专为编程新手设计。

01 · 先理解它是什么

Claude Code 的核心概念

在开始使用任何命令之前,先建立正确的心智模型。

💡
Claude Code ≠ 网页版 Claude

你已经熟悉在 claude.ai 上和 Claude 对话了。Claude Code 是运行在终端里的 AI 编程助手——它可以直接读写你电脑上的文件、运行命令、操作 Git,而网页版 Claude 只能跟你聊天。

把 Claude Code 想象成一个坐在你旁边的高级程序员同事,你用自然语言告诉他想干什么,他直接帮你写代码、改文件、跑测试。

🪟
上下文窗口 (Context Window) — 最核心的概念

Claude 的「大脑工作台」大约有 200,000 tokens(约 15 万字)。每次你和它对话,对话历史 + 读取的文件 + 生成的代码 都占用这个空间。

当它满了,Claude 就会「忘事」——回答质量下降、忽略你之前的要求。所以管理上下文窗口是使用 CC 最关键的技能

1 新对话开始
2 读文件 + 对话,token 累积
3 到 70% 注意!
4 /compact 或 /clear
🔑
三个运行环境
环境说明适用场景
终端 (Terminal) 直接在命令行里用 最灵活,功能最全
VS Code 插件 在编辑器侧边栏运行 边看代码边对话
Web 版 在浏览器中运行异步任务 长任务,后台执行
02 · 打开正确的方式

启动 Claude Code

不同的启动命令决定了 Claude 在什么模式下工作。

四种启动姿势
命令模式何时使用
claude 交互模式(REPL) 开始新的持续对话最常用
claude "你的请求" 带初始 prompt 进入交互 快速开始特定任务
claude -p "问题" 一次性模式,回答后退出 快速提问,不需要持续对话
claude -c 继续上次的对话 中断后想接着之前的工作超好用
Terminal
# 进入你的项目目录(重要!在项目目录启动) $ cd ~/my-project # 启动交互模式 $ claude # 或者直接带着任务启动 $ claude "帮我分析这个项目的文件结构" # 昨天对话到一半关掉了?继续! $ claude -c
⚠️ 关键:一定要在项目目录启动

Claude Code 会自动读取当前目录的文件。如果你在桌面或用户根目录启动,它看不到你的项目代码。

03 · 你的遥控器

核心斜杠命令 (Slash Commands)

在对话中输入 / 开头的命令来控制 Claude Code 的行为。掌握 5 个就能覆盖 80% 的需求。

🧹
/clear — 清空对话,重新开始

最高频 清除当前所有对话历史,释放 100% 已用 token。但不会删除你的文件或 CLAUDE.md 记忆。

🎯
什么时候用?
切换到完全不同的任务时。比如刚帮你写了个网页,现在要改数据库逻辑——果断 /clear,别让旧上下文污染新任务。
📦
/compact — 压缩对话,保留关键信息

最高频 让 Claude 把之前的对话总结成精华,token 消耗减少 50-70%,同时保留关键决策和上下文。

还可以指定保留重点:/compact "聚焦在 API 接口的部分"

🎯
什么时候用?
还在做同一个任务,但对话已经很长了。比如一直在调试同一个 bug,不想丢掉之前的进展——用 /compact 而不是 /clear
💰
/cost — 查看当前消耗

显示当前会话的 token 使用量和预估费用。对于 Max 订阅用户,虽然不直接花钱,但 token 用量影响限速。

🎯
什么时候用?
在做完一个大的重构操作后检查一下消耗,或者觉得 Claude 回复变慢时看看上下文是不是快满了。
🧠
/memory — 编辑项目记忆文件

直接打开当前项目的 CLAUDE.md 文件进行编辑。每次 Claude Code 启动时都会读取这个文件,它就是 Claude 对你项目的「长期记忆」。

/rewind — 撤销上一轮操作

当 Claude 改错了文件,不用手动撤销!/rewind 相当于「Ctrl+Z」,回退到上一个状态。可以连续多次使用。

🎯
什么时候用?
Claude 刚改了你的代码但改崩了,赶紧 /rewind 回退,然后换一种方式重新描述你的需求。
💡 其他有用的命令速览

/help 查看帮助 · /model 切换模型 · /init 初始化项目 CLAUDE.md · /context 查看上下文用量 · /review 代码审查

04 · 最关键的技能

上下文窗口管理

CC 的质量 = 上下文质量。学会管理它,你就掌握了 CC 的核心。

📊
上下文使用指南
使用率状态你应该做什么
0 - 50% 🟢 舒适区 放心工作,不用管
50 - 70% 🟡 注意 开始留意,复杂任务前考虑 /compact
70 - 90% 🟠 警告 立即 /compact,精度已在下降
90%+ 🔴 危险 必须 /clear 重新开始
⚖️
/clear vs /compact:怎么选?
/clear/compact
做了什么 删除所有对话历史 智能总结对话,保留要点
释放空间 100% 50-70%
保留信息 只保留 CLAUDE.md 保留关键决策和上下文
适用场景 切换到新任务 继续当前任务但需要空间
🧠 一句话记住

换话题 → /clear,同话题但太长了 → /compact

05 · 给 Claude 长期记忆

CLAUDE.md 记忆系统

每次启动 CC 时自动加载的配置文件,决定了 Claude 对你项目的理解。

📁
三层记忆结构
位置作用范围用来放什么
~/.claude/CLAUDE.md 全局(所有项目) 你的个人偏好、通用编码风格、常用工具
项目/CLAUDE.md 当前项目 项目概述、技术栈、构建命令、编码规范
项目/.claude/CLAUDE.md 当前项目(隐藏版) 同上,放 .claude 文件夹里不影响项目目录
📝
CLAUDE.md 写什么?
CLAUDE.md
# 项目概述 这是一个基于 Python Flask 的 RESTful API 项目 用于管理投资组合和市场数据分析
# 技术栈 - Python 3.11 + Flask - PostgreSQL 数据库 - Redis 缓存
# 常用命令 - 启动开发服务器: flask run --debug - 运行测试: pytest tests/ - 数据库迁移: flask db upgrade
# 编码规范 - 使用中文注释 - 每个函数都要有 docstring - 变量名使用 snake_case
💡 快速创建方式

在项目目录中运行 /init,Claude 会自动分析你的项目并生成一份 CLAUDE.md。你再手动编辑补充即可。

06 · 安全第一

权限控制

Claude Code 默认每次改文件或跑命令都会问你「可以吗?」。了解如何高效管理权限。

🛡️
三种权限模式
模式行为适合谁
默认模式 每次操作都询问你 新手,需要理解 CC 在做什么推荐
Auto-accept 自动批准文件编辑,仍询问命令执行 有经验的用户,项目有 Git 保护
跳过权限 全部自动批准 专家模式(高风险
权限操作示例
# 在 CC 对话中管理权限 > /permissions # 允许运行特定命令(不再每次询问) 添加允许规则: Bash(npm run test:*) 添加允许规则: Bash(python *) # 用 Shift+Tab 切换权限模式 按 Shift+Tab 可在对话中切换
⚠️ 新手建议

作为编程新手,建议保持默认模式。每次 Claude 要修改文件时仔细看一下它要改什么,这本身就是很好的学习过程。确认项目已经初始化了 Git 后,可以尝试 Auto-accept 模式——万一改坏了可以用 git 回退。

07 · 把它串起来

典型工作流程

把前面学的组合起来,看看一个完整的使用流程是什么样的。

🏗️
流程一:开始一个新项目
1 cd 到项目目录
2 claude
3 /init
4 /memory 补充细节
5 开始提需求
🔧
流程二:长时间开发会话
1 正常对话开发
2 /cost 检查消耗
3 用量>60%? /compact
4 继续开发

💡 如果中途需要切到完全不同的任务 → 先 /clear,再开始新任务

🐛
流程三:出了问题怎么办
1 Claude 改崩了代码
2 /rewind 回退
3 换一种方式描述需求
4 重试

💡 如果 /rewind 也不行,还有 Git:git checkout . 恢复所有改动

⌨️
必知快捷键
快捷键作用
Esc停止 Claude 当前操作(不是 Ctrl+C!Ctrl+C 会退出整个程序)
Esc Esc双击 Esc 显示历史消息列表,可以跳转
浏览之前的输入历史
Shift+Tab切换权限模式
@引用文件路径,如 @src/main.py
/输入斜杠命令,按 Tab 自动补全
08 · 实战速查表

「我想做 X,应该怎么操作?」

常见场景和对应的最佳操作。

📖
想了解一个新的代码项目
cd 项目目录claude → 问「这个项目是做什么的?」「解释一下文件结构」「主入口在哪里?」
想添加一个新功能
直接用自然语言描述:「帮我添加一个用户登录页面,支持邮箱密码登录」。描述越具体,结果越好。
🐛
有个 Bug 要修
贴上报错信息:「运行时报这个错 TypeError: Cannot read property 'id',帮我修复」。可以用 @文件路径 指向出错文件。
📝
想让 Claude 提交代码
直接说「帮我提交这些改动,写好 commit message」。Claude 会用 Git 帮你完成。
🔄
对话太长,Claude 开始犯糊涂
输入 /compact(还在同一个任务)或 /clear(要换任务了)。
💥
Claude 把代码改坏了
别慌!输入 /rewind 回退。或者在 Git 仓库中用 git checkout . 恢复。
🏃
昨天的对话还没做完
终端输入 claude -c 继续上次对话。或者 claude -r 从历史对话中选择要恢复的那个。
🎯
想让 Claude 执行一个 Skill
输入 /skill名字 来调用。例如你创建了一个 review skill,就输入 /review。也可以直接描述需求,如果 skill 的 description 写得好,Claude 会自动识别并使用。
09 · 检验你的学习成果

互动测验

8 道题,看看你掌握了多少。点击选项即可作答。

0/8
正确率