Claude Code 101
面向开发者的实战课。无论你是刚入门的工程师，还是没用过 AI 编程代理的老手，这门课会带你从安装到高级定制，把 Claude Code 用进日常开发流程。
在互动学院中学习（含测验与进度保存）→Claude Code 是一个在你的终端（命令行）里运行的 AI 编程代理。和聊天式 AI 不同，它能直接读取、修改你项目里的文件，运行命令，帮你真正地把代码写出来、跑起来。
Claude Code 是一个能直接操作你代码库的编程代理，可以读文件、改代码、运行命令形成闭环，而不只是给出文本建议。
理解 Claude Code 背后的几个概念，能帮你更好地驾驭它：代理循环、上下文窗口、工具和权限。
Claude Code 的工作方式是一个循环：理解你的目标 → 选择一个工具（读文件、改代码、运行命令）→ 看结果 → 决定下一步，直到任务完成。它会自己一步步推进，而不是一次性给完答案。
上下文窗口是 Claude「当前能记住的内容」的容量。项目越大、对话越长，占用越多。学会管理上下文（后面会讲 /compact、/clear、/context）能让它保持高效。
Claude Code 通过「工具」来读写文件、运行命令。出于安全，危险操作会先征求你的同意——你可以逐次批准，也可以开启自动接受。你始终掌握控制权。
# 启动 Claude Code claude # 然后用自然语言描述任务 > 帮我在 src/utils.js 里写一个把秒数格式化成 mm:ss 的函数，并补一个测试
代理循环是 Claude Code 自主推进任务的方式：不断地选择工具、观察结果、决定下一步，直到目标达成。
安装 Claude Code 只需要几分钟。它是一个 npm 包，装好之后你就能在任何项目目录里用命令行唤起它。这节课带你完成安装、认证和初次探索。
# 第一步：全局安装 Claude Code npm install -g @anthropic-ai/claude-code # 第二步：检查安装是否成功 claude --version # 第三步：启动并完成首次认证 claude # 首次运行会引导你登录 Anthropic 账号或输入 API key
第一次运行 claude 时，终端会提示你登录。如果你有 Claude 账号（Pro/Max），选择通过浏览器登录；如果你使用 API key，选择输入 key 的方式。认证完成后，Claude Code 会保存凭据，之后启动不需要重复登录。
Claude Code 是一个 Node.js 工具，通过 npm install -g @anthropic-ai/claude-code 全局安装。安装后用 claude 命令启动。
安装好 Claude Code 之后，就进入一个真实的项目目录，发出你的第一条指令。这节课演示最经典的开场白：让 Claude Code 读懂一个代码库，然后用自然语言告诉你它是干什么的。
Claude Code 的能力依赖于它所在的目录。在哪个目录里启动，它就能读取那个目录里的文件。所以第一步，cd 进入你的项目目录，然后再运行 claude。
# 进入你的项目目录 cd /path/to/your/project # 启动 Claude Code claude # 然后在提示符后输入你的第一个任务 > 读一读这个项目，用中文告诉我：这是什么项目，主要做什么，技术栈是什么，入口文件在哪里？
收到这个指令后，Claude Code 会开始读取项目文件：先看 package.json 或 README，再读主要的源码目录，然后给你一份清晰的项目概览。整个过程你可以在终端里看到它在读哪些文件，这就是代理循环在实际运行。
Claude Code 能读取的文件范围取决于它启动时所在的目录。应该先 cd 进入你的项目目录，再运行 claude。
Claude Code 最推荐的工作方式是四步走：先让它探索代码库，再一起规划方案，然后写代码，最后你审查并提交。跳过前两步直接叫它「改代码」，往往会让它走弯路。
在动手之前，先让 Claude Code 读懂相关文件。这和你自己阅读代码是一回事——理解了上下文，才能做出正确的修改。可以让它读指定的文件、模块或测试，告诉你它理解了什么。
不要直接说「去改这个文件」，而是先和 Claude Code 讨论方案：「为了实现 X，你打算怎么做？要改哪些文件？有没有潜在风险？」让它把计划说出来，你确认之后再开始写代码。这一步能发现很多误解和隐患。
规划确认后，让 Claude Code 开始写代码。代码写完后，仔细检查 diff，确认改动符合你的预期，再提交。不要跳过这一步——Claude Code 很能干，但最终的质量把关在你。
# 探索阶段 > 先读一下 src/auth/ 目录下的文件，告诉我用户认证流程是怎么实现的 # 规划阶段 > 我需要在 token 过期时自动弹出重新登录的提示。你打算怎么改？要动哪些文件？ # 编码阶段 > 好，按你说的方案去改，一个文件一个文件地来，每改完一个告诉我
规划阶段让 Claude Code 把要做什么、怎么做说清楚，你确认后再开始编码。这能避免理解偏差导致的大量返工。
上下文窗口是 Claude Code「当前记忆」的容量。对话越长、读的文件越多，上下文就越满。学会管理上下文，能让 Claude Code 始终保持高效、不走弯路。
每一次 Claude Code 的会话都有一个上下文窗口——它能「看到」和「记住」的内容总量是有限的。当上下文快满时，Claude 会开始忘记之前的内容，或者行为变得不稳定。你可以用 /context 查看当前的使用情况。
# 查看当前上下文使用量 /context # 压缩上下文（保留关键信息，删除冗余历史） /compact # 清空上下文，从头开始（用于切换完全不同的任务） /clear
/clear 会完全清空当前对话上下文，让 Claude Code 以全新的状态开始下一个任务。/compact 只是压缩，适合同一任务继续推进。
Claude Code 不只是写代码的助手，它也是一个很好的代码评审员。无论是审查你自己写的代码，还是在接受 Claude Code 的改动之前仔细核查，代码评审是保持代码质量的关键习惯。
把你写的代码发给 Claude Code，让它找问题：潜在的 bug、边界条件、性能问题、代码风格、安全漏洞。它的视角和你不同，往往能发现你自己忽略的问题。
# 评审一个具体文件 > 帮我评审 src/api/user.js 这个文件，重点关注：1) 有没有潜在的安全问题 2) 错误处理是否完善 3) 有没有明显的性能问题 # 让它解释自己的改动 > 你刚才修改了 auth.js，告诉我你具体改了什么、为什么这么改，有没有潜在的副作用
在接受 Claude Code 的任何改动之前，都应该审查一遍。养成看 git diff 的习惯，确认每一行改动你都理解并认可。特别注意 Claude Code 有时会改动它「顺手」改了但你没要求的地方。
Claude Code 的输出需要你审查后才能接受。看 git diff、理解改动逻辑，是保持代码质量的关键步骤。
CLAUDE.md 是放在项目根目录里的一个 Markdown 文件，专门写给 Claude Code 看的。每次 Claude Code 在这个项目里启动，它都会先读这个文件，了解你的项目背景和规范。
没有 CLAUDE.md 时，每次开新对话你都要重新告诉 Claude Code「我们用 TypeScript」「测试用 Jest 跑」「提交信息要用英文写」。CLAUDE.md 把这些一次写清楚，之后每个会话都自动生效，你再也不用重复交代背景。
# CLAUDE.md 示例结构 ## 项目简介 这是一个用 Next.js + TypeScript 构建的电商平台前端。 ## 技术栈 - 框架：Next.js 14（App Router） - 语言：TypeScript（严格模式） - 样式：Tailwind CSS - 测试：Vitest + React Testing Library - 包管理：pnpm ## 常用命令 - 启动开发服务器：pnpm dev - 运行测试：pnpm test - 构建：pnpm build ## 规范与约定 - 组件放在 src/components/，按功能模块分子目录 - Git 提交信息用英文，遵循 Conventional Commits 格式 ## 不要做的事 - 不要安装新的 npm 包，除非我明确要求 - 不要改动 .env 文件
CLAUDE.md 是写给 Claude Code 看的项目说明文件，让它在每次会话开始就了解技术栈、规范和约束，不需要你每次重复介绍。
Subagents（子代理）是 Claude Code 可以派生出来、在独立上下文里完成特定任务的助手代理。当一个大任务可以拆成多个独立的部分时，Claude Code 会自动或在你的提示下，把子任务委派给子代理并行处理。
当你给 Claude Code 一个可以并行处理的复杂任务时，它可能会自动拆解并派生多个子代理同时工作。比如：「同时给 user、product、order 三个模块写单元测试」——Claude Code 可以派三个子代理各自写一个模块，比串行处理快得多。
子代理让多个独立任务可以同时进行，不必排队串行处理，对于可以拆分的大任务效率提升非常明显。
Skills 是可以赋予 Claude Code 特定专长的可复用模块。把某类任务的标准做法封装成一个 Skill，Claude Code 就会在合适的时候自动调用它，给出更专业、更一致的结果。
在 Claude Code 的上下文里，Skill 通常是项目里一个专门的目录（如 .claude/skills/），里面放着描述特定工作方式的 Markdown 文件。Claude Code 在处理相关任务时会读取并遵循这些文件里的规范。
Skills 把特定任务的规范和做法封装起来，每次 Claude Code 处理该类任务时都会遵循，确保输出的一致性和专业性。
MCP（Model Context Protocol）让 Claude Code 能连接外部工具和数据源——数据库、API、代码质量工具、内部服务等等。通过 MCP 服务器，Claude Code 的能力边界大幅扩展。
# 通过命令行添加（推荐新手） claude mcp add <server-name> <command> [args...] # 例如：添加一个本地 SQLite MCP 服务器 claude mcp add sqlite npx -y @modelcontextprotocol/server-sqlite ./mydb.db
MCP 服务器向 Claude Code 暴露一组工具和数据接口，接入后 Claude Code 就能在对话中调用这些工具，如查询数据库、调用 API 等。
Hooks 让你可以在 Claude Code 执行工具的前后，自动运行你指定的 shell 命令。比如：每次 Claude Code 改完一个文件，自动跑一遍格式化；每次运行命令前，先做一个安全检查。
Hook 是绑定在 Claude Code 工具调用生命周期上的钩子。目前支持两种：PreToolUse（工具调用之前运行）和 PostToolUse（工具调用完成之后运行）。你可以指定匹配哪些工具、运行什么命令。
// .claude/settings.json 示例
// 每次 Claude Code 写文件后，自动运行 prettier 格式化
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write",
"hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }]
}
]
}
}PostToolUse hook 在工具调用完成后触发，最适合做格式化、lint、测试等后处理工作，让 Claude Code 的每次改动都自动符合规范。
欢迎来到 Claude Code 101 的课程综合测验。这里有 8 道题，覆盖本课程的核心概念。测验不计入成绩，重点是帮你回顾和巩固学到的内容。
Claude Code 是一个编程代理，能直接操作你的代码库——读文件、改代码、运行命令，而不是只给出文字建议。
代理循环是 Claude Code 自主推进任务的方式：不断地选择工具、执行、观察结果，再决定下一步行动，直到完成目标。
CLAUDE.md 是专门给 Claude Code 看的项目说明，每次 Claude Code 启动时都会读取，让它了解背景和规范。
/clear 会完全清空当前上下文，让 Claude Code 以全新状态开始下一个任务。/compact 只是压缩历史，适合同一任务继续推进。
MCP 服务器向 Claude Code 暴露外部工具和数据，让它能在编程工作中直接查询数据库、调用 API、访问内部服务等。
子代理让多个独立子任务可以并行处理，每个子代理有自己的上下文，最适合可以拆分的大型并行任务。
PostToolUse Hook 在工具调用完成后触发，最适合做格式化、代码检查、自动测试等后处理工作，让每次改动都自动符合规范。
规划阶段让 Claude Code 先说出它打算怎么做，你确认方向正确后再开始编码，能有效避免理解偏差和大量返工。
想要测验互动、进度自动保存的完整体验？
进入 AI 学院互动版 →