本文由 莫潇羽@源码七号站（www.fuyuan7.com）撰写，转载请注明出处。

快速摘要

先把结论摆在最前面：Claude Code 不是又一个能写代码的聊天框，而是一个直接在终端里替你改文件、跑测试、提交代码的命令行编程搭档；Agent Skills 则是给它——以及 Codex、Trae、CodeBuddy 这些同样支持该标准的工具——外挂的「技能包」，用一份 SKILL.md 加上可选的脚本和参考文档，把你脑子里的专业流程沉淀成 AI 能反复调用的能力。两者的关键词其实是同一个：把「给你提建议」升级成「替你把活干完」。

这篇我会从最基础的安装、命令、四种工作模式讲起，把 CLAUDE.md、Git/GitHub 集成、MCP、自定义命令这些日常高频的东西一个个拆开；然后进到 Agent Skills，把它的三层渐进式加载原理、目录结构、从零搭建到跨平台部署完整走一遍；最后再深入一层，聊聊从工程角度看这类工具为什么稳、它的自修复和上下文压缩思路怎么搬到你自己的 Agent 上，以及插件系统和绕不开的安全话题。

内容偏长，是我自己一段时间折腾下来的实践笔记，新手也能跟着上手。想看完整拆解，往下翻。

一、先把 Claude Code 到底是什么讲清楚

刚接触的人很容易把它和别的工具划等号，但用过一阵你会发现它走的是另一条路。

1.1 它和 Cursor、通义灵码这类工具差在哪

我们之前用得多的 AI 编程工具，大多带一个图形界面：左边是文件树，中间是编辑器，你选中一段代码，在侧栏对话框里提问，它给你一段补全或一条修改建议，你点接受。Cursor、通义灵码、CodeBuddy 大致都是这个路子，本质上仍然是「人在驾驶，AI 在副驾给提示」。

Claude Code 反过来。它完全跑在终端里，没有自己的图形编辑界面，你看到的就是一个命令行对话框。你输入一句自然语言——比如「帮我修一下登录接口的空指针问题」——它会自己去读项目里的文件、定位问题、改代码、跑测试，整条链路它自己走完。这种交互一开始会让人不太习惯，毕竟没有按钮可点，但效率确实高，因为中间那些「你点一下、它再动一下」的来回被省掉了。

差别说白了在自动化程度。带界面的工具因为有可视化的确认环节，很多场景下是半自动的，需要你不断介入；Claude Code 把这一层默认收了起来，它能分析整个代码库、理解项目架构，然后端到端地把一个任务执行完。它的底层就是一个 agent——会拆任务、会调工具、会根据结果决定下一步——这是它和「补全式」工具最根本的不同。

1.2 一句话定位：会动手干活的搭档

我自己给它的定位是：它已经不只是编码工具了，而是一款生产力工具。它的适用人群也不局限于个人开发者——技术团队、甚至偏管理的角色都能用，因为它能覆盖从需求理解、方案规划到代码实现、测试、审查的全流程，而不只是「写一段函数」。

一句话总结这一节：以前的工具给你建议，Claude Code 直接帮你把事做了。理解了这个定位，后面所有的命令和模式才有意义。

二、安装与第一次启动

2.1 三种常见安装路径

官方给的安装方式有好几种，最省事的是用包管理器全局安装。装完之后在终端敲一下版本号确认没问题，就可以用了。我个人建议优先装最新版本，很多奇怪的小问题在新版里其实已经修掉了，遇到命令不识别、报错的情况，第一反应先看版本对不对。

Windows 用户这里有个常见坑：官方的安装命令分 PowerShell 和 CMD 两套写法，贴错了会提示 'irm' is not recognized 或者 && 不是有效分隔符之类。看到这种报错别慌，多半是终端环境贴错命令了，对着官方文档(code.claude.com/docs)把对应环境的那条复制过去就行。

2.2 第一次进入：claude 命令与信任目录

安装好之后，进入你的项目目录，直接敲：

claude

它会先问你是否信任当前目录，回车确认就进了交互界面。界面很干净，就是一个输入框。你也可以启动时直接带上问题：

claude "分析这个项目的整体结构"

这样它进来就直接开始干活，省掉一步。终端用 Windows 自带的 CMD 可以，但我更推荐用体验好一点的终端工具（比如 Windows Terminal），中文显示和交互都顺一些。

2.3 集成进 VS Code / Cursor / Trae

如果不想纯在命令行里折腾，可以把它集成进编辑器。在 VS Code 或 Cursor 的扩展市场里搜 Claude Code 的官方插件装上，装完编辑器里会多一个图标，点开就是一个带对话窗口的面板。这个面板底层还是命令行那套，但多了可视化的展示，调用细节看得更清楚。我自己写复杂任务时喜欢用这个面板版，能更直观地看到它每一步在读哪个文件、执行哪条命令。

提醒一句：早期在 Python 等环境里直接装的那个版本可能比较老、还是纯命令行；VS Code、Cursor 里的插件版本通常升级过，体验更好。把 Claude Code 集成进 Cursor 这类工具，两边结合着用，效果会比单用一个强不少。

三、必须先记住的基础命令

这些斜杠命令是你和 Claude Code 打交道最高频的东西，掌握了它们，使用体验会顺很多。下面我先用一张表把常用的几个列出来，再挑重点说几句。

3.1 上下文管理：/clear 与 /compact

这两个最常用。聊得久了，上下文越堆越长，模型的注意力会分散，开始出现「你以为它懂了，结果执行起来偏到姥姥家」的情况。/clear 是直接把当前上下文清掉重开，干净利落；/compact 则是把对话压缩一下——你可以理解成把一长串聊天「蒸馏」成一份摘要，关键信息留着，啰嗦的过程砍掉，既避免溢出又不至于把背景全丢了。

我的习惯是：发现它方向开始不对，先 /clear 重启再换个说法；如果只是历史太长但任务还得接着做，就 /compact。

3.2 看花了多少 token：/cost

如果你用的是按量计费的 API 或者免费额度，养成随手 /cost 的习惯很有必要。它会告诉你这场对话累计用了多少 token、大概花了多少钱。在长会话或者密集生成代码的时候，偶尔瞄一眼，发现飙升就及时提更具体的问题、压缩上下文，能省下不少开销。

3.3 切换模型：/model

/model 会弹出可选模型让你挑。Claude 系列一般分几个档：默认那款均衡，速度和能力兼顾，日常用它就够；还有更强但更贵的款，适合啃复杂问题；以及成本最低、速度最快但效果相对弱的款。大部分时候默认款足矣，遇到硬骨头再切最强款。

3.4 配置与初始化：/config 与 /init

/config 是交互式改配置，主题、自动压缩开关、编辑模式都能在里面调。/init 更重要——它会扫描你的项目，自动生成一份 CLAUDE.md。这份文件是后面整个工作流的基石，下一章专门讲它。

3.5 几个进阶但很实用的命令

再补几个我用得上的。会话管理这块，/resume 能切回历史会话，你之前开过的多个对话都列在那儿，想接着哪个聊就挑哪个；/rename 给会话改名，方便区分。还有个回滚功能，能把会话退回到之前某一步的状态——它一通操作之后你觉得改歪了，不用从头来过，退回去重来即可。

命令行层面，claude -c 可以恢复到上一次的对话（continue），适合你不小心关掉终端、或者卡死了看不到结果，重进接着干；claude -r 则是从历史里挑一个会话恢复（resume）。这两个我踩过坑：以前不知道，会话一断就重头来，知道之后省了不少事。

最后提一个进阶玩法——无头模式（headless）。前面进的都是交互界面，其实加个 -p 参数就能把它当纯命令行工具用：

# 直接出结果，不进交互界面
claude -p "解释一下这个文件做了什么" < some_file.py
# 也能接管道，把日志丢给它分析
cat logs.txt | claude -p "找出其中的异常"

加了 -p 它不进对话界面，直接给你答案，还能指定 JSON 格式输出。这种模式适合脚本自动化、CI/CD 流程——你想把 Claude Code 的能力嵌进自动化部署里，就用它。日常交互我们用界面版，需要把它当一个「输入进、结果出」的工具时，无头模式更顺手。

四、四种工作模式，决定了你「放手」的程度

Claude Code 写代码时，到底要不要每一步都等你点头？这由工作模式决定。按 Shift+Tab 可以在几种模式间切换，搞清楚它们，你才能拿捏「什么时候让它自动跑、什么时候必须人盯着」。

4.1 默认询问模式

最稳的一档。它每要执行一个有副作用的动作（改文件、跑命令）前，都会停下来问你一句「要继续吗」，你确认它才动。修历史项目的 bug、在陌生仓库里排查问题时，我都用这个，宁可多点几下，也不想它瞎改。

4.2 自动编辑模式（Shift+Tab）

按 Shift+Tab 切到自动编辑，它就不再为每次编辑停下来问你了，会连续地把活干完。适合那种你已经看明白方向、信任它能稳定输出的重复性工作。

4.3 计划模式：只出方案不动手

这是我个人很喜欢的一档。在计划模式（Plan Mode）下，Claude Code 只给方案、列步骤、做技术调研，但不真正动手改东西。前期做需求分析、架构规划、风险点梳理特别合适——先让它把思路理清楚，你审一遍方案，觉得没问题再切到执行模式让它干。把「思考」和「执行」分开