Claude Code 实战全流程笔记

CLAUDE CODE 实战全流程

光会敲几个命令
还远远不够

从安装登录到插件全家桶，把编程 Agent 真正落地到生产环境的一条完整链路。

终端命令 · 快捷键 · 上下文管理 · 扩展能力

导读

Claude Code 很火，关注编程 Agent 的同学大多已经上手体验过。但要把它从“会用”变成“顺手”，中间还差一整条实战流程。

这份笔记按真实操作顺序拆成四块：环境搭建与基础交互、复杂任务处理与终端控制、高级功能的扩展与定制，以及上下文管理等具体问题。

起步：安装与登录

三步装好

来到官网页面，点击复制按钮，回到终端粘贴执行，安装就开始了。
新建项目目录，例如用 mkdir my-todo，所有代码都放进去。
进入目录，执行 claude 命令打开 Claude Code。

两种官方接入方式

订阅制：已购买 Pro 或 Max 会员，直接选这一项。
API Key：按 token 用量计费，用多少花多少。

进入后如未提示登录，可执行 /login 主动触发。选完后会弹出网页请求授权，同意即登录成功，关掉页面回到终端按回车完成。

若无法使用官方订阅或 API，也可以接入 GLM、MiniMax 等国产模型。Claude Code 本身不绑定 Claude 模型，设置几个环境变量即可驱动。

三种模式，Shift + Tab 循环切换

默认模式

建改文件前必询问
最稳妥

自动模式

自动创建修改
最方便

规划模式

只讨论不落笔
适合构思

自动模式的标志：输入框下方出现 accept edits on。
规划模式的标志：出现 plan mode。
底部那行灰色的 ? for shortcuts 只是提醒按问号看快捷键，它不是一种模式，这个状态就是默认模式。

终端里的三个实用操作

用叹号直接跑终端命令

输入一个 !，就进入 bash 模式，可以运行任意终端命令，比如 open index.html 直接打开生成好的页面。

换行用 Shift + 回车

直接敲回车会把问题提交出去，想换行必须按 Shift + 回车。如果这个组合键不好用，大概率是版本太旧，升级一下即可。

Ctrl + G 换到编辑器里写

觉得终端输入框难用，可以按 Ctrl + G，Claude Code 会打开一个 VS Code 标签页。在里面随便按回车都不用担心误提交，写完保存关闭，内容会自动回到输入框。

权限边界与后台任务

自动模式只覆盖“写文件”

即使在 accept edits on 下，执行终端命令依然会弹窗询问。
因为终端命令被判定为较危险的操作，且没有“全部自动执行”的选项。
弹窗里的第二项，只是允许它以后自由访问 src 目录，别的命令照样要问。

跳过一切确认的启动参数

启动时加上 --dangerously-skip-permissions，模式会变成 bypass permissions on，之后安装依赖、删除文件、创建目录都不再询问。

参数里的 dangerously 是官方写在自己脸上的警告。开启后它理论上拥有与你同等的终端权限，效率极高，但风险由自己承担。

服务阻塞时按 Ctrl + B

开发服务器跑起来后会阻塞会话，此时输入内容得不到任何回应。
按 Ctrl + B 把服务放到后台，Claude Code 立刻恢复响应。
输入 /tasks 查看后台任务，按 K 结束它，按 ESC 返回界面。

让服务一直跑着，后续的修改就能实时看到效果。

回滚：/rewind 与双击 ESC

每次发出请求，Claude Code 都会创建一个回滚点。
输入 /rewind，或直接连按两下 ESC，进入回滚页面。
选中回滚点回车后，有四个选项：代码和会话一起回滚、只回滚会话、只回滚代码、放弃回滚。

它只能回滚自己写入的文件

由终端命令生成的文件，例如 mkdir、npm install 产出的内容，Claude Code 是回滚不掉的。用 ls -a 就能看到它们还在。

别太依赖回滚功能。要精准回滚，用 git 会更好。

照着设计稿改页面：图片与 MCP

方法一：把图片丢给它

把设计稿导出为 PNG，直接拖进 Claude Code，输入框出现 image 即代表接收成功。
或复制文件后按 Ctrl + V 粘贴。注意：Mac 上也是 Control，不是 Command。
接着描述需求，让它按图改代码。

缺点是还原不够精确，字体、间距这类细节很难从图片里准确把握。

方法二：接入 Figma MCP Server

复制官方安装命令，连按两下 Ctrl + C 退出后执行安装。
重开会话：用 /resume 找回之前的对话，或启动时加 -c（continue）自动恢复上一次对话。
执行 /mcp 查看工具，选择该 MCP 并 authenticate 授权，回来后状态即为可用。
在 Figma 里复制设计稿链接，回到终端粘贴发送，让它自行判断该用哪个工具。

它会调用 get design context 与 get screenshot，拿到的不仅有截图，还有组件间距、字体样式等详细信息，还原精度明显更高。

上下文：压缩与清空

/compact 压缩

可以直接执行，也可以在后面追加压缩策略，例如重点保留用户提出的需求。
按 Ctrl + O 查看压缩后的上下文内容。
好处：性能有保障，后续执行任务时 token 消耗也少很多。

/clear 清空

做法更极端，直接把所有上下文内容清空。当后面的任务与之前的内容并无关联时使用。

两个局限：压缩结果不可手动编辑；上下文与某个会话绑定，下次进来还得回到这个会话。

CLAUDE.md：每次进来都读的项目说明

执行 /init，让 Claude Code 自动生成一份 CLAUDE.md，放在当前目录。
内容可随意修改，也可以让它翻译成中文。
写在里面的内容每次启动都会被读取。例如在末尾加一句“每次回答最后必须追加 happy coding”，重启后它真的照做。
改了文件后需退出并重新进入，才会重新加载。

用 /memory 直接打开文件

项目级：文件放在当前目录，对当前项目生效。
用户级：文件放在用户目录，对当前用户生效。

选中对应项，文件会自动打开，比去文件管理器里翻要方便得多。

Hook：写完代码自动格式化

执行 /hooks 进入配置页面。
选择执行时机，这里选 PostToolUse，即工具使用后触发。
选择目标工具，填 Write 或 Edit，也就是创建或编辑文件时触发。
再填入具体的格式化命令。

命令思路：Claude Code 会传入一段 JSON，其中 file_path 是刚编辑好的文件路径；用 jq 把它取出来，通过 xargs 交给 prettier 完成格式化。

保存范围三选一

本地项目级：配置写入 settings.local.json，并加入 gitignore，不共享给别人。
项目级：写入 settings.json，随 git 分发给所有使用该项目的人。
用户级：保存在用户目录，对当前用户生效，不随项目分发。

验证方式：让它写一个内容全在一行的 HTML 文件，最终生成的却是格式整齐的代码。

Agent Skill：写一份给模型看的说明书

可以把它理解成一个动态加载的 prompt。
在用户目录的 .claude/skills 下新建文件夹，例如 daily-reports。
在其中创建 SKILL.md，分两部分：前面的 name 和 description 决定模型是否调用它，后面是具体要求，比如日报需要遵循的格式。
重启后执行 /skills，能看到它已被发现。

两种调用方式

直接说需求，由模型自己识别并请求调用。
输入 /daily-reports 加具体请求，跳过意图识别环节，结果更可控。

Sub Agent：独立上下文的专家

执行 /agent，选择 create new agent，再选项目级或用户级。
创建方式推荐“由 Claude Code 初始化”，也可完全手动。
描述它的职责，例如：这是一个用于代码审核的 Sub Agent，在用户要求代码审核时调用。
工具只勾选 read only，模型选默认的 sonnet，再为它挑一个颜色。
生成后可自行编辑替换成适合自己场景的版本，结构同样是元数据加具体职责。

按 E 即可编辑描述。触发后，Claude Code 会用你配置的颜色来展示它。

Agent Skill

完全继承并共享主对话的上下文，执行过程中的每一行日志、每一个思考都会进入当前上下文。

Sub Agent

拥有完全独立的上下文。中间的代码与推理过程不回传主对话，只带回一个最终结果汇报。

怎么选

与上下文关联大、且对上下文影响不大的任务，用 Skill，例如根据今天的开发过程写日报。
与上下文关联小、但对上下文影响很大的任务，用 Sub Agent，例如审核一个几万行的项目。

如果让 Skill 去审几万行代码，中间过程会逐步塞满上下文窗口，token 消耗飙升，Agent 还会因记忆过载而变慢变傻。

Plugin：能力的全家桶

可以理解为把一系列 skill、Sub Agent、hook、MCP 打包在一起，一键安装即可获得整套能力。
执行 /plugin 进入管理器，其中有三项：discover 发现新插件、installed 已安装、marketplaces 插件市场。
在 discover 中找到插件回车安装，范围可选对当前用户、当前项目，或当前用户的当前项目生效。

实测 frontend-design 插件

安装后重启，用 /skills 能看到多了一个同名的 agent skill——装插件本质上就是装了这个 skill。
让它在“按 frontend-design 的要求做”的前提下生成页面，它会先请求读取该 skill，再动手写代码。
对比最初的原生版本，排版更高级、色彩更协调、交互更符合现代审美。

插件市场还在快速增长，除了 UI 设计，也有针对特定编程语言的 LSP 插件等。觉得自己的配置足够好，也可以按官方文档打包成插件分享给团队或社区。

“

一通百通

Codex、OpenCode 等同类编程 Agent，在功能和使用上并没有太大区别

✓

行动建议

先用默认模式跑通一个完整项目，熟悉每一次确认的含义，再逐步切到自动模式提速。

把项目放进 git。回滚只覆盖它自己写入的文件，终端命令产出的内容它管不了。

长会话及时 /compact，跨任务用 /clear，让上下文保持轻装。

把反复粘贴的格式要求沉淀成 Agent Skill，一次写好，长期复用。

只有确实需要独立上下文时才用 Sub Agent，避免主对话被中间过程撑爆。

先看懂 --dangerously-skip-permissions 的代价，再决定是否为效率承担这份理论风险。

由 CuteNote.app 颜值笔记生成