Appearance
一、新手入门
npm i -g @anthropic-ai/claude-code安装 Claude Code/init初始化项目,自动扫描代码库生成 CLAUDE.md@文件名或@目录/引用上下文,支持模糊匹配!bash命令直接执行,无需切换窗口- 双击 Esc 回滚(可选:只回退对话/代码/全部)
- Ctrl+S 暂存当前 Prompt,稍后自动恢复
- Tab 接受 AI 灰色显示的下一步建议
/clear清理上下文,开启新对话/compact压缩上下文,删除冗余内容/help查看所有命令
二、会话管理
--continue断点续传,继续上次对话--resume选择要恢复的会话/rename xxx给会话命名,方便后续恢复--teleport session_xxx云端同步,网页端和本地互通,支持 iOS/Android/桌面端/export导出对话成 Markdown,包含所有 prompt、回复、工具调用- 会话默认保存 30 天,可配置 cleanupPeriodDays(0=立刻清理,365=保留一年)
/resume界面支持分组、预览、键盘快捷键- 新会话不继承旧历史,通过 /export + 引用文件实现上下文复用
三、效率提升
/vim开启 Vim 风格编辑(h j k l / ciw / dd / w b / A)/statusline自定义状态栏,显示 Git 分支/当前模型/Token 用量/脚本输出/context查看 Token 花在哪了,上下文快满时知道该删什么/stats查看使用统计、连续天数、模型偏好/usage查看额度剩余,带可视化进度条- Ctrl+R 搜索之前用过的复杂 Prompt
- Tab 接受/编辑 AI 建议,Enter 直接运行
/extra-usage购买额外容量- 可以在 /config 里配置建议提示的开关
/model随时切换模型(opus/sonnet/haiku)
四、思考与规划
ultrathink开启深度思考,分配最多 32K tokens 用于内部推理,适合架构设计/难缠 bug/性能优化- 按两次 Shift+Tab 进入 Plan 模式,先规划再动手
- Plan 模式流程:读代码→分析依赖→起草方案→等你批准→才开始写代码
- Extended Thinking API:thinking blocks 显示 AI 推理过程
- ultrathink 成本是普通对话的 3-5 倍,但输出质量明显更好
- "一个好的计划真的很重要" — Boris(Claude Code 创建者)
五、权限与安全
/sandbox预设允许/禁止的操作范围,如允许 npm install、禁止 rm -rf/permissions预授权已知安全的 bash 命令,比 YOLO 模式更安全--dangerously-skip-permissions跳过所有确认(隔离环境/可信操作用)- 权限设置写入 .claude/settings.json,可与团队共享
- 支持通配符:mcp__server__* 允许所有 MCP 服务器
- 危险操作(rm -rf)会自动拦截,即使在 YOLO 模式
六、自动化与 CI/CD
claude -p "任务"非交互模式,适合脚本/GitHub Actionsgit diff | claude -p "Explain these changes"管道输入方式claude -p "List all functions" | grep "async"二次处理输出- 把常用 Prompt 保存为 .md 文件,自动变成 slash 命令
/your-command运行自定义晨会流程或 SOP/install-github-action安装 GitHub Action- GitHub Action 实现 PR 自动 review + 规则自动更新
- 配合 cron 实现定时自动化任务
七、Hooks 生命周期
- PreToolUse — 工具使用前触发
- PostToolUse — 工具使用后触发(如自动格式化代码)
- PermissionRequest — 权限请求时触发
- Notification — 通知发送时触发
- SubagentStart/Stop — 子代理启停时触发
- 典型用法:每次改代码后自动运行测试 / push 前自动 lint / 拦截 force push 到 main / 操作完成后发 Slack 通知
八、多 Agent 与团队协作
后台任务
- Ctrl+B 将当前任务推入后台
/agents查看运行中的后台任务- 任务完成时终端弹出通知
- 最佳场景:独立功能模块、批量重复、耗时研究分析
- 不适合:需频繁确认、高度依赖、实时调试
Git Worktree + 后台代理
git worktree add ../feature-xxx feature/xxx创建独立工作目录- 每个 worktree 有独立文件系统、Git 历史,互不干扰
- 在不同 worktree 里同时跑多个 Claude 实例
git worktree remove干净清理实验分支
并行场景
- 多维度 Code Review:安全+性能+重构+冗余四路并行,10分钟拿四份报告
- 批量组件迁移:分10组,10个后台代理并行,两小时干完两天活
- A/B/C 测试:极简版+功能完整版+性能版三路并行,同时跑同时对比
Agent Teams
- 分配任务时背景+目标+约束要写全(队员不继承主对话历史)
- 文件归属划清楚,避免两个 Agent 同时改一个文件
- blockedBy 设置任务依赖,前置完成自动解锁
- Lead 动态追加任务(如发现重要情报自动深挖)
- 队长用 Opus,队员用 Sonnet,省钱
- 产出持久化到磁盘,不是聊天记录飘过就没了
团队共享
- 团队共享同一个 CLAUDE.md,check 进 git
- 看到 Claude 犯错 → 立即加规则 → 形成飞轮:犯错→记录→学会→犯更少错
- Code Review 时 @.claude 让它自动把规则加到 CLAUDE.md
- PostToolUse 钩子自动格式化代码,处理最后 10%
九、Skill 与 MCP
- MCP = 专业厨房(工具/食材/设备访问)
- Skill = 菜谱(创建特定成果的逐步指令)
- Skill 三大场景:文档生成、工作流自动化、MCP 增强
- 渐进式披露:YAML元数据→SKILL.md正文→链接文件(按需加载,最小化 Token)
- SKILL.md 建议控制在 500 行左右,大块内容拆到 references/
- 5种骨架模式:顺序工作流/多MCP协调/迭代优化/上下文感知/领域特定智能
- 设计类 Skill:哲学先行(两步走),代码只是表达工具
- "概念种子":把主题嵌进参数/行为/模式,而不是嵌进画面
- 最后一轮精修:不做加法做乘法(问"能删什么"而不是"加什么")
- Skill 要写清楚判断条件、出错处理、返回上一步的方法
- 触发不足 → 描述加细节和技术术语关键词
- 过度触发 → 添加负面触发,让描述更具体
十、调试与排错
/health检查 Claude Code 自身状态和配置claude --version查看当前版本,升级前先查 changelog- 遇到异常时先看终端完整报错,不要只截最后一行
--verbose开启详细日志,适合排查奇怪问题/restart重启 Claude Code,解决状态异常- 善用
/clear清理后重新开始,避免上下文污染
十一、文件与上下文
@文件名直接引用单个文件,支持 Tab 补全@目录/引用整个目录,AI 会理解目录结构- 双击 Tab 自动补全,减少手动输入
/open 文件:行号直接跳转到指定文件和行号- 善用 @ 引用而非粘贴代码,避免格式丢失和 Token 浪费
!read 文件路径在对话中直接读取文件内容
十二、心法
- "给 Claude 验证工作的方式" — 写代码→测试→发现问题→修复→再测试,闭环形成后质量提升 2-3 倍
- 并行思维 — 本地5个+网页端5-10个 Claude 实例,不是单线作战
- 文件即指令、结构即功能、git 即时间线 — Agent Teams 的产品设计哲学
- 团队飞轮 — 犯错→记录→学会→犯更少错,CLAUDE.md 持续迭代
- 用子代理做流程自动化,不做专家分工 — 避免上下文分割
- Claude 用所有工具 — MCP服务器搜索/发消息、BigQuery查询、Sentry抓错误日志
- 越是有明确标准、越重复性劳动,Skill 价值越大
- Agent Teams 实用场景优先级:调研类(只读不写)> 文档生成 > 代码开发 > 复杂多文件修改