Claude Code 学习笔记：常用命令与 CLI 深度使用

为什么学 Claude Code

把 Claude Code 作为最重要的 AI Agent 工具来学习，原因有二：一是它是不同于 ChatGPT 的 Agent 模式的集大成者，二是它拥有最好的模型。

这篇笔记整理了 Claude Code 的核心用法：会话内的斜杠命令、命令行下的深度用法（参数与管道）、实用插件，以及我自己和 Agent 分工的一些体会。

会话内命令

会话内命令以 / 开头，覆盖会话管理、配置、诊断、扩展等场景：

命令	说明
/init	创建 CLAUDE.md
/compact	压缩上下文，可指定参数，例如”保留关于设计的讨论”
/clear	清空上下文，开始新任务时使用
/export xxx.md	将会话内容导出为文档
/cost	看 token 消耗
/status	以下三个都是一样的
/usage
/config
/model	会话中切换模型
/help	查看所有命令
/doctor	检查安装健康状况，排查问题用
/permissions	查看/修改工具权限
/terminal-setup	配置终端快捷键（如 Shift+Enter 换行）
/vim	开启 vim 编辑模式
/theme	配色主题
/login、/logout	登录、登出
/release-notes	看看更新日志
/resume	恢复对话，会给出会话历史，自己选
/add-dir	把路径加入进来一起分析
/memory	编辑 claude.md 文件，会让用户选编辑全局的还是项目的
/mcp	查看和管理 MCP 服务器
/agents	管理子代理（subagent）
/tasks	查看命令
/exit	退出 cc，退出时会提示如何恢复这次对话的命令
/rewind	回退代码修改。按两次 esc，会打开更改列表，上下键选择回退的版本

日常使用频率最高的是 /clear 和 /compact 这一对：前者清空上下文开始新任务，后者在上下文将满时压缩并保留关键信息。

另外还支持自定义命令：在 .claude/commands 中定义一个 deploy.md，写明要做的操作，就可以在终端中直接使用这个命令，且支持参数定义。

! 开头则可以执行 shell 指令。

CLI 深度使用

常用参数

参数	说明
-p	完成后中断对话
—verbose	命令行尾部添加，会显示必要步骤（实测没有显示）
-c	继续上次退出 claude 前的 session（对话）
—output-format txt/json/stream-json	输出格式的定义，后两者查看起来很乱，主要是给 LLM 看的
—max-turns	限制对话轮数
—model	模型选择
—append-system-prompt “你是系统工程师”	附加说明
— cmd	指定工作目录
—resume \	恢复指定会话，是 -c 的精确版（对应 /resume 命令）
—add-dir \<路径>	启动时额外添加可访问目录，对应会话中的 /add-dir 命令

其中 -p（print 模式）是自动化的关键：非交互执行，完成后直接输出结果并退出，适合脚本和管道场景。

--add-dir 也很实用。默认 claude 只能读写启动时所在的目录，如果项目要引用别处的文件（比如另一个仓库的代码），就用它把其他路径加进来。

单个指令调用

不用进入交互模式，直接在命令行里一句话完成任务，好处是速度快：

1
2
3

claude "这个仓库是做什么的"
claude "修改 main.cpp 文件，提交文件"
claude commit

串流处理（管道）

听起来就像 Linux 中的管道，可以把任何命令的输出喂给 claude 分析：

1 2	cat qurey.txt \| claude -p git log --oneline -10 \| claude -p "分析这些提交的模式"

与其它工具整合，有如下用法：

1
2
3

git diff | claude -p "解析这些变更的影响"
npm test 2&1 | claude -p "分析测试失败的原因"
tail -f app.log | claude -p "监控异常模式"

这个模式把 claude 变成了管道中的一环：上游产生数据，claude 负责理解和总结，非常适合接在 CI、日志监控等自动化流程里。

插件备忘：claude-hud 状态栏

本节内容原文发布于 2026-06-21（《Claude Code 使用备注》）。

claude-hud 是一个状态栏（statusline / HUD）插件，在界面底部显示上下文占用、模型信息、任务进度等，让长时间任务里对会话资源消耗有直观感知。

安装步骤：

1
2
3

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins

安装完成后运行 /claude-hud:setup 初始化配置，后续调整显示内容用 /claude-hud:configure。

使用体会：我和 Agent 的分工方式

本节内容原文发布于 2026-06-03（《Vibe Coding 接触下来的一点体会》），有删节。

2026 年工作方式最大的变化是开始使用 AI Agent。以前用 ChatGPT 网页端对话，因为对项目非常熟悉、工作都是函数级别的修改，网页聊天足够；切换到 Agent 模式后，发现它很挑战使用者的水平——即便在大厂，Agent 总体来说提效有限，进度把控、交付质量还是要打问号，往往靠加班填补。也观察到一些研发对 Agent 的依赖导致丧失了对工程的熟练度：以前大部分代码手敲，做事有掌控感；现在拿着 AI 生成的代码，大家都在慢慢适应。

我的想法是：Agent 技术一定要用，而且拿出专门时间学，目标是提高工作质量的上限，而不只是图一时干活快。具体策略有几条：

不陷入过度准备：本来想攒够 Agent 知识再开干，后来觉得这样遥遥无期，索性用常用的 20% 基础功能先跑起来，事实证明挺好。
用规范指导，而非随口对话：纯对话往往词不达意，有走一步看一步的不踏实感。改成先写规范（编码规范沉淀为 .clang-format，工程规范沉淀为学习资料），让规范指导 Agent。
用 Agent 消化存量资产：用 CC 梳理了大学老师留下的老代码，沉淀出一套独特的编码规范和工程规范，以前没注意到的工程技术也能借助 CC 消化掉。这是用规范驱动 CC 的第一步。
重度参与编码：不是所有项目都全交给 AI——写代码本身有乐趣和成就感，全交出去会回到本文开头说的问题。目前的选择是部分项目（如非 C++ 项目）尽量交给 AI 把控，其余的自己深度参与，还在练。

小结

会话内用 / 命令管理会话和配置，记住 /clear、/compact、/resume 就够日常使用了。
命令行用 -p 加管道，可以把 claude 嵌入任何现有工作流，这是它区别于聊天框式 AI 的核心能力。
装上 claude-hud，对上下文消耗心里有数。
工具之外更重要的是分工：规范先行、重度参与编码，Agent 用来抬高质量上限，而不是替代自己。