Claude Code 教程

Claude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具。它的定位不是聊天窗口，而是在本地项目目录中理解代码、读取文件、执行命令、修改工程并根据反馈继续推进任务的终端型智能体。

如果你想要的是“左边看目录，右边从头到尾连续阅读”的教程体验，这一页就是完整入口，不需要在几十个卡片页面之间来回点击。

谁适合阅读本教程

• 已经学习过至少一门编程语言，能够读懂基础语法、函数、条件和循环。
• 写过简单项目或正在维护已有项目，希望借助 AI 提升开发效率。
• 不满足于“复制粘贴几段代码”，而是想让 AI 真正参与工程任务推进。
• 独立开发者、团队骨干、技术负责人，都适合把 Claude Code 当成长期协作工具。

需要具备的基础能力

• 会使用命令行，至少知道如何切换目录、查看文件和执行常见命令。
• 会使用编辑器或 IDE，并能理解文件结构、配置文件和日志输出。
• 愿意审查 AI 的产出，而不是把每一次回答都当成绝对正确的结果。
• 能够识别业务边界，知道哪些决定必须由人来拍板。

Claude Code vs 网页版 Claude

安装与登录

Claude Code 的核心体验发生在终端里，所以安装过程通常从 Node.js 和命令行环境开始。安装完成后，再进行登录授权和版本确认。

node -v
npm -v
npm install -g @anthropic-ai/claude-code
claude --version
claude login

如果你在公司机器、代理网络或 Windows 环境下使用，优先确认 Node 版本、终端权限和代理设置。安装失败时，先看错误堆栈，不要盲目重复执行。

首次进入项目

安装完成后，不是立刻让 Claude Code “帮我写个功能”，而是先让它理解当前项目。最稳妥的启动方式，是进入项目根目录，再发出一个让它先阅读再总结的任务。

cd your-project
claude

# 进入后可以先这样说
请先阅读当前仓库结构，说明主要模块、启动方式和关键配置，再给出阅读建议。

这样做的好处是，Claude Code 会先建立项目上下文，而不是在信息不足的情况下直接修改代码。

常用命令

日常使用时，你最常接触的是启动、执行、查看状态、切换模式这几类命令。下面给你一个实用速查表。

斜杠命令

斜杠命令是 Claude Code 会话里的高频入口，用来控制上下文、切换状态、压缩历史和调用能力。你可以把它理解成“会话内的操作面板”。

/help
/status
/compact
/clear
/model
/config

/compact 特别重要。当对话变长、上下文被历史内容挤占时，用它压缩上下文，能明显提升后续回答的稳定性。

Skills

Skills 是 Claude Code 扩展能力的重要方式。它不是简单的提示词收藏夹，而是一套带触发条件、输入输出约束和参考实现的可复用能力包。

团队里经常重复出现的工作流，比如代码审查、排障流程、生成项目脚手架、执行固定检查，都适合沉淀成 Skill。

skills/
└── code-review/
    ├── SKILL.md
    ├── references/
    ├── scripts/
    └── examples/

Hooks

Hooks 用来把检查动作挂到关键节点上。比如修改文件后自动执行格式化，运行命令前后自动记录信息，或者在某些操作前要求额外确认。

{
  "on_file_change": ["npm run lint"],
  "before_command": ["echo check command"],
  "after_command": ["echo command finished"]
}

Hooks 的价值不是炫技，而是减少“改了代码却忘了跑检查”这种低级失误。

MCP

MCP 可以把文件系统、数据库、浏览器、接口文档、工单系统等外部能力接进 Claude Code。这样 Claude Code 不只会看本地文件，还能在受控范围内访问你授权的外部工具。

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

[mcp_servers.browser]
url = "http://localhost:3001/mcp"

使用 MCP 时，最重要的是边界控制。只接入真正需要的工具，不要把一切都暴露给模型。

权限与审批

Claude Code 的强大能力建立在明确的权限规则之上。你要让它高效，但不能让它在没有约束的情况下随意执行高风险操作。

• 低风险读取类操作可以相对放宽，让它先理解项目。
• 涉及删除、覆盖、联网、长时间运行命令时，应当增加审批。
• 团队项目建议统一规则文件，避免每个人的权限边界完全不同。

上下文管理

Claude Code 能否稳定完成任务，很大程度取决于上下文是否干净、是否聚焦。上下文管理包含三个核心动作：提前给规则、控制会话长度、在必要时重新聚焦任务。

• 用项目说明文件告诉它目录、规范、禁区和输出要求。
• 对大任务分阶段推进，不要一条提示里塞过多目标。
• 历史内容过长时，使用 /compact 压缩或开启新会话。

Subagents

当一个任务包含代码审查、运行检查、文档整理、跨目录分析等多个子目标时，可以让 Claude Code 分配不同的子代理并行处理。这样做的意义在于拆分复杂度，而不是单纯追求“多开”。

适合使用子代理的场景包括：大仓库结构调研、前后端改动影响分析、批量页面巡检、复杂问题分步排查。

实战工作流

如果你想把 Claude Code 真正用起来，建议按下面的节奏，而不是让它一上来就“从零做完整系统”。

1. 先让它阅读仓库，输出结构理解和关键模块。
2. 再让它只处理一个很具体的小任务，比如修一个页面、补一个接口日志、改一个组件。
3. 改完立刻让它执行最相关的检查或构建命令。
4. 最后再让它总结改动范围、风险点和下一步建议。

请先阅读当前项目结构，找到与登录页相关的文件。
只修改 UI，不改接口逻辑。
改完后运行前端构建命令并总结改动与风险。

常见问题

为什么它有时很聪明，有时又跑偏？

因为 Claude Code 不是读心工具。上下文不完整、任务目标不清晰、权限边界混乱，都会让结果变差。

是不是给它越多任务越好？

不是。一个会话里塞太多目标，反而会让它在不同目标之间来回漂移。复杂任务最好拆阶段推进。

它能完全替代程序员吗？

不能。它能提升效率、减少重复劳动、加速排查和重构，但最终的技术判断、业务判断和上线决策仍然是人的责任。

相关资源

联系方式