Claude Code（CC）从零到精通完全指南

这篇文章不是只讲“怎么安装一个命令行工具”，而是把 Claude Code 当成一个可以读文件、改代码、跑命令、调用工具、沉淀项目规则的 AI Agent 来理解。

如果你刚接触 Claude Code，最容易卡住的地方通常不是某个命令，而是不知道它到底和普通聊天机器人有什么区别：它什么时候能自己做事，什么时候需要你确认，什么时候该给它更多上下文，什么时候又该清空上下文重新开始。

这篇教程按“先理解，再安装，再实战，再扩展”的顺序整理，适合从零开始搭建自己的 Claude Code 工作流。

一、先理解 Claude Code 是什么

Claude Code 可以先理解成一个运行在本地开发环境里的 AI Agent。

它和普通聊天式 AI 最大的区别是：

  • 普通聊天 AI 主要负责回答问题。
  • Claude Code 可以在项目里读取文件、修改文件、执行终端命令，并根据结果继续下一步。

也就是说，它不是只和你聊天，而是在一个“理解任务 -> 制定计划 -> 执行动作 -> 观察结果 -> 继续修正”的循环里工作。

1.1 核心能力

Claude Code 的核心能力可以拆成三类：

*

本地项目理解
它可以读取当前目录里的代码、文档、配置和日志，从项目上下文里理解任务。

*

自动执行任务
它可以创建文件、修改代码、运行测试、启动服务，并根据报错继续排查。

*

工具生态扩展
它可以通过 Skills、MCP、Hooks、插件和子 Agent，把能力扩展到代码审查、设计稿解析、浏览器操作、GitHub 协作等场景。

1.2 适合做什么

Claude Code 最适合这些场景：

  • 编程开发：新功能、Bug 修复、重构、测试补齐、代码解释。
  • 知识工作：文档整理、报告生成、资料归纳、流程沉淀。
  • 内容创作：课程大纲、脚本改写、素材整理、结构优化。
  • 自动化处理：批量整理文件、生成模板、调用外部命令行工具。

它的优势不是“永远一次做对”，而是能在本地环境里持续观察、执行和修正。

二、安装前准备

正式安装前，建议先准备好下面几项。

2.1 基础环境

Windows 用户建议至少准备：

  • PowerShell 或 Windows Terminal
  • Node.js
  • Git
  • 一个常用代码编辑器，比如 VS Code、Cursor 或其他 IDE

macOS 用户建议准备：

  • Terminal 或 iTerm2
  • Node.js
  • Git
  • 常用编辑器

安装完成后，可以先检查版本：

123node -vnpm -vgit -v
如果这些命令能正常显示版本号，说明基础环境已经可用。

2.2 网络环境

Claude Code 默认连接 Anthropic 服务，国内网络环境下可能会遇到登录失败、连接超时、回调打不开等问题。

更稳妥的做法是：

  • 浏览器和终端使用同一套网络环境。
  • 如果使用代理，优先开启系统级代理或 TUN 模式。
  • 遇到连接失败时，先排查网络出口，再排查账号和工具本身。

如果终端没有走系统代理，可以临时设置代理环境变量。

Windows PowerShell：

12$env:https_proxy="http://127.0.0.1:7897"$env:http_proxy="http://127.0.0.1:7897"
macOS / Linux：

12export https_proxy=http://127.0.0.1:7897export http_proxy=http://127.0.0.1:7897
端口号要按自己本机代理软件的实际配置调整。

三、安装与启动

Claude Code 最常见的安装方式是通过 npm 全局安装。

1npm install -g @anthropic-ai/claude-code
安装完成后检查版本：

1claude –version
进入一个项目目录后启动：

1claude
首次启动时通常会遇到几类初始化步骤：

  • 登录账号或配置模型服务。
  • 选择界面主题。
  • 确认是否信任当前项目目录。
  • 允许或拒绝某些操作权限。

新手建议先在一个测试项目里体验，不要一上来就把重要生产项目交给完全自动模式。

四、模型配置思路

Claude Code 默认使用 Anthropic 官方模型。如果你已经有可用账号，按登录流程完成授权即可。

如果你需要接入第三方模型或统一管理多个模型供应商，可以使用类似 CC Switch 这类工具，把 API Key、Base URL 和模型名称集中配置好，再让 Claude Code 走对应入口。

这类配置的核心不是记住某个工具界面，而是理解三件事：

  • API Key：调用模型的身份凭证。
  • Base URL：模型服务的接口地址。
  • Model：本次使用的具体模型名称。

配置第三方模型时，建议先在工具里测试一次连通性，再启动 Claude Code。这样排障会简单很多。

五、基础交互方式

Claude Code 的日常使用可以从四种输入方式开始。

5.1 直接输入任务

最简单的方式是直接描述你想做什么。

1帮我阅读这个项目，并总结它的目录结构和启动方式。
如果任务比较复杂，建议把目标、范围和验收标准讲清楚。

12请只修改登录页相关代码，不要动数据库结构。完成后运行现有测试，并告诉我改了哪些文件。

5.2 引用文件

当你希望它重点看某个文件时，可以直接引用文件名或路径。

1请解释 @src/app/page.tsx 的主要逻辑。
引用文件的好处是减少无效探索，让模型更快进入关键上下文。

5.3 输入图片或文件

Claude Code 支持多模态输入时，可以把截图、设计稿、报错图、日志文件等作为上下文。

常见用法：

  • 上传界面截图，让它定位样式问题。
  • 粘贴报错截图，让它结合代码排查。
  • 上传设计稿，让它生成对应页面结构。

5.4 使用斜杠命令

斜杠命令适合快速调用内置能力或插件能力。

常见命令包括：

命令
作用
适合场景

/clear
清空当前会话上下文
切换到新任务

/compact
压缩上下文
长任务中途继续推进

/resume
恢复历史会话
重启后继续之前任务

/model
切换模型
需要不同能力或成本时

/status
查看当前状态
检查账号、模型或额度

/init
生成项目规则文件
新项目建立协作规范

/agents
管理子 Agent
复杂任务分工

不同版本和插件环境下，可用命令会有差异。输入 / 后以实际列表为准。

六、权限模式怎么选

权限模式决定 Claude Code 能自动做到什么程度。

新手最需要理解的是：权限越高，效率越高，但误操作风险也越高。

模式
特点
适合场景

计划模式
先给计划，确认后再执行
复杂任务、架构调整、重要项目

默认模式
低风险操作自动执行，高风险操作询问
日常开发

自动编辑模式
可以更主动地改文件
已信任项目、明确任务

危险模式
权限非常高，可能直接执行敏感命令
临时隔离环境，不建议新手常用

我的建议是：

  • 学习期优先用计划模式和默认模式。
  • 熟悉项目后再使用自动编辑模式。
  • 危险模式只放在可丢弃的测试环境里使用。

七、终端命令与后台任务

Claude Code 能执行终端命令，但并不意味着所有命令都应该塞进同一个会话里。

更稳的习惯是：

  • 长时间运行的服务放在独立终端里。
  • 构建、测试、格式化这类短命令可以交给 Claude Code 执行。
  • 删除、覆盖、批量移动文件前先确认范围。

有些环境支持在对话里用感叹号执行命令：

1!npm run test
如果启动了长时间运行的服务，可以按工具提示把进程转入后台，避免阻塞当前对话。

八、版本控制与回滚

只要让 AI 改代码，就一定要配合版本控制。

Claude Code 可以帮助你：

  • 初始化 Git 仓库。
  • 生成 .gitignore。
  • 查看当前改动。
  • 提交阶段性版本。
  • 根据历史提交回滚。

如果你发现它改偏了，可以优先尝试：

  • 使用 /rewind 或连续按两次 Esc 回到之前状态。
  • 用 Git 查看具体差异。
  • 必要时从某个提交恢复文件。

这里最重要的习惯是：复杂任务开始前先提交一次干净版本。这样就算过程走偏，也有明确的安全点。

九、上下文管理

Claude Code 能处理长任务，但上下文不是无限的。

当对话越来越长时，容易出现这些问题：

  • 模型忘记最开始的约束。
  • 旧信息干扰新任务。
  • 响应变慢。
  • Token 占用升高。

常用处理方式：

操作
适合场景

/compact
当前任务还没结束，但上下文太长

/clear
一个任务结束，准备开始新任务

/resume
找回历史会话

新开终端或新会话
任务边界完全不同

如果一个任务已经跑完，建议把关键结论写进项目文档或规则文件，而不是一直依赖对话历史。

十、用 CLAUDE.md 固化项目规则

CLAUDE.md 可以理解成给 Claude Code 看的项目说明书。

它适合写这些内容：

  • 项目背景
  • 技术栈
  • 目录结构
  • 常用命令
  • 编码规范
  • 测试要求
  • 禁止事项
  • 发布流程

常见层级如下：

层级
位置
作用

全局级
用户目录下的 Claude 配置目录
所有项目通用偏好

项目级
项目根目录的 CLAUDE.md
当前项目规则

子目录级
某个模块目录下的规则文件
特定模块规则

新项目可以先输入：

1/init
让 Claude Code 生成第一版项目说明，再手动补充真实业务约束。

十一、自动记忆与自定义文档

如果启用了记忆能力，Claude Code 可以沉淀一些长期偏好和项目经验。

适合写入记忆的内容：

  • 你偏好的回答语言。
  • 常用技术栈。
  • 不希望重复解释的个人习惯。
  • 某个项目的长期约束。

不适合写入记忆的内容：

  • 临时任务细节。
  • 密钥、Token、密码。
  • 还没确认的猜测。
  • 只对一次会话有效的中间结论。

除了记忆，还可以准备专门的文档，例如：

  • docs/architecture.md
  • docs/api.md
  • docs/style-guide.md
  • docs/release.md

然后在 CLAUDE.md 里说明什么时候应该参考这些文件。

十二、Skills、MCP、Sub Agent、Hooks 和插件

Claude Code 真正强的地方，是可以继续扩展。

12.1 Skills

Skills 可以理解成“给 AI 用的专业操作手册”。

它适合沉淀：

  • 固定流程
  • 专业规范
  • 工具调用方式
  • 项目内重复任务

例如：

  • 代码审查 Skill
  • 前端设计 Skill
  • 文档共创 Skill
  • 视频字幕转 Markdown Skill

12.2 MCP

MCP 是 Model Context Protocol，用来把外部工具和数据源接给 AI。

常见场景包括：

  • 读取 Notion、GitHub、Figma 等外部服务。
  • 查询数据库。
  • 调用浏览器自动化能力。
  • 获取实时文档或项目上下文。

MCP 很强，但也会占用上下文和增加配置复杂度。新手建议先从少量必要连接开始，不要一口气装太多。

12.3 Sub Agent

Sub Agent 适合把复杂任务拆出去并行处理。

例如：

  • 一个 Agent 查代码结构。
  • 一个 Agent 写测试。
  • 一个 Agent 修复样式。
  • 主 Agent 负责整合结果。

它的价值是减少主上下文污染，并让多个独立任务同时推进。

但也要注意：并行不是越多越好。任务边界不清时，多个 Agent 反而会互相干扰。

12.4 Hooks

Hooks 可以理解成“条件触发器”。

例如：

  • 每次提交前自动运行格式化。
  • 任务完成后播放提示音。
  • 修改某类文件后自动运行测试。
  • 执行危险命令前额外提醒。

Hooks 适合把重复动作自动化，但要先确认触发条件准确。

12.5 插件

插件通常会把 Skills、MCP、Hooks、命令等能力打包在一起。

你可以通过插件获得更完整的工作流，比如：

  • GitHub 协作
  • 浏览器自动化
  • 代码审查
  • 文档处理
  • 数据库操作

安装插件时建议遵循一个原则：先解决真实问题，再安装对应插件。

十三、我建议的新手练习路线

如果你是从零开始，可以按下面顺序练。

13.1 第一阶段：只做阅读和解释

练习任务：

  • 解释项目结构。
  • 总结某个文件功能。
  • 找出启动命令。
  • 帮你画出模块关系。

目标是先习惯它怎么读项目。

13.2 第二阶段：做小范围修改

练习任务：

  • 修改一个按钮文案。
  • 增加一个表单校验。
  • 修复一个小 Bug。
  • 给某个函数补测试。

目标是学会看 diff、跑测试和回滚。

13.3 第三阶段：做完整功能

练习任务：

  • 新增一个页面。
  • 接一个 API。
  • 写一套配置文档。
  • 完成一次小型重构。

目标是学会把需求讲清楚，并让它按计划执行。

13.4 第四阶段：沉淀工作流

练习任务：

  • 写 CLAUDE.md。
  • 整理常用命令。
  • 创建自己的 Skill。
  • 给项目加检查和发布流程。

目标是让 Claude Code 从“临时助手”变成“项目协作者”。

十四、使用时最容易踩的坑

14.1 指令太短

一句“帮我优化一下”通常不够。

更好的写法是：

12请只优化首页首屏的移动端样式，不改业务逻辑。完成后运行构建命令，并说明改动文件。

14.2 不看 diff

AI 改完后，一定要看改动。

重点看：

  • 有没有动到无关文件。
  • 有没有删掉已有逻辑。
  • 有没有硬编码。
  • 有没有遗漏错误处理。

14.3 一直在同一个会话里做所有事

任务边界变化后，要及时 /clear 或新开会话。

例如：

  • 修 Bug 是一个会话。
  • 写文档是另一个会话。
  • 发布上线再开一个会话。

14.4 没有版本控制

没有 Git 的 AI 协作非常危险。

建议至少做到：

  • 任务前提交一次。
  • 任务中阶段性提交。
  • 任务后检查 diff。
  • 发布前确认构建和测试通过。

十五、总结

Claude Code 的关键不是“会不会安装”，而是能不能把它放进一套稳定工作流里：

  • 用清楚的任务描述减少误解。
  • 用权限模式控制风险。
  • 用 Git 保存安全点。
  • 用 CLAUDE.md 固化项目规则。
  • 用 Skills、MCP、Hooks 和插件扩展能力。

当你掌握这些之后，Claude Code 就不只是一个命令行聊天工具，而是一个可以参与真实项目推进的 AI Agent。

参考资料