C ClaudeCode 学习记载一、模式切换按 Shift+Tab(官方文档是这样写的，但我的是 alt+m) 键轮回切换三种模式：

| 默许模式 | Claude 在文献剪辑和 shell 号召之前都会征询证明 | | Accept Edits | 平时的代码修改自动施行，唯有触及 shell 号召时才需要手动批准 | | Plan Mode | 不起始施行，只生成料到有想象 |

| ! | Shell 号召 | 输入 ! 后头接号召，径直施行对应的 shell 号召 | !dir → 径直施行 dir 号召，裸露当前目次下的文献 | | @ | 援用文献 | 输入 @ 后接旅途，会列出该旅途下的文献和文献夹供遴荐 | 已知旅途 x1/x2/x3，输入 @x1 → 列出 x1 目次下的文献和文献夹 | | & | 备注阻挡 | 在一段要求之后追加 & 加阻挡条款，手脚补充讲明 | 写了一大堆要求后输入 & 用英语呈报 |

| /init | 使用 CLAUDE.md 指南运鼎新情势。缔造 CLAUDE_CODE_NEW_INIT=1 得到交互式经由 | | /clear [name] | 启动新对话，之前的对话在 /resume 中保合手可用。笔名：/reset、/new | | /resume [session] | 按 ID 或称呼收复对话，或大开会话遴荐器。笔名：/continue | | /compact [instructions] | 通过回归对话来开释高下文，可传递焦点讲明 | | /recap | 按需生成当前会话的单行节录 | | /branch [name] | 创建当前对话的分支，可用 /resume 复返。笔名：/fork | | /rewind | 将对话和/或代码倒回到上一个点。笔名：/checkpoint、/undo | | /rename [name] | 重定名当前会话，不传称呼则自动生成 | | /export [filename] | 将当前对话导出为纯文本 | | /btw | 提倡快速附加问题，不添加到对话中 |

| /add-dir | 为当前会话添加使命目次。.claude/ 建树不会从添加的目次中发现 | | /diff | 交互式各异稽察器，裸露未提交篡改和每轮各异 | | /context [all] | 将当前高下文使用情况可视化为彩色网格，传递 all 伸开确定 | | /doctor | 会诊并考证 Claude Code 安设和缔造。按 f 让 Claude 种植问题 | | /status | 裸露版块、模子、账户和邻接性状况 | | /tasks | 列出并不断后台任务。笔名：/bashes |

| /model [model] | 遴荐或篡改 AI 模子，可调度使命量级别 | | /effort [level | auto] | 缔造使命量级别：low/medium/high/xhigh/max，auto 重置为默许 | | /permissions | 不断器具权限的允许、征询和拒却规矩。笔名：/allowed-tools | | /sandbox | 切换沙箱模式，仅在解救的平台上可用 | | /fast [on | off] | 切换快速模式 | | /extra-usage | 建树非凡使用量，达到速率限定时继续使命 |

| /usage | 裸露会话本钱、料到使用限定和举止统计。笔名：/cost、/stats |

| /review [PR] | 在当前会话中土产货审阅 pull request | | /ultrareview [PR] | 在云沙箱中运行多 agent 深度代码审查。Pro/Max 含 3 次免费 | | /autofix-pr [prompt] | 监视当前分支 PR，CI 失败或审阅者指摘时自动推送种植。需要 gh CLI | | /security-review | 分析待处理篡改的安全罅隙（注入、认证问题、数据浮现等） |

| /batch | 在统共这个词代码库中并行编排大限制篡改，解析为独处单位，在阻隔 worktree 中生成后台 agent 并开 PR | | /loop [interval] [prompt] | 重迭运行请示。不详间隔自动调速，不详请示运行自主顾惜检查。笔名：/proactive | | /simplify [focus] | 审阅最近篡改的文献，查找代码重用、质料和遵循问题并种植 | | /debug [description] | 为当前会话启用调试日记比肩查问题 | | /claude-api [migrate | managed-agents-onboard] | 加载 Claude API 参考贵府。migrate 升级 API 代码到新模子，managed-agents-onboard 创建新 Managed Agent | | /fewer-permission-prompts | 扫描历史记载，为常用只读操作添加允许列表，减少权限请示 |

| /plan [description] | 径直插足 Plan Mode，可传形色立即起始任务 | | /ultraplan | 在浏览器中审阅料到，然后汉典施行或发送回终局 | | /schedule [description] | 创建/更新/列出/运行 routines（在 Anthropic 云基础顺次上施行）。笔名：/routines |

| /login | 登录 Anthropic 账户 | | /logout | 登出 Anthropic 账户 | | /help | 裸露匡助和可用号召 | | /exit | 退出 CLI。笔名：/quit | | /copy [N] | 复制第 N 个最新反馈到剪贴板。有代码块时裸露交互式遴荐器，按 w 写入文献 | | /keybindings | 大开或创建快捷键建树文献 | | /terminal-setup | 建树终局快捷键（Shift+Enter 等），仅在需要的终局中可见 | | /voice [hold | tap | off] | 切换语音听写模式 | | /chrome | 建树 Claude in Chrome 缔造 | | /ide | 不断 IDE 集成并裸露状况 | | /insights | 分析 Claude Code 会话（情势界限、交互模式、摩擦点） | | /install-github-app | 为存储库缔造 Claude GitHub Actions 愚弄 | | /install-slack-app | 安设 Claude Slack 愚弄 | | /mobile | 下载 Claude 出动愚弄二维码。笔名：/ios、/android | | /release-notes | 稽察版块更新日记 | | /team-onboarding | 从使用历史生成团队入职指南 | | /powerup | 快速交互式课程发现 Claude Code 功能 | | /radio | 大开 Claude FM lo-fi 电台 | | /stickers | 订购 Claude Code 贴纸 | | /passes | 分享一周免费 Claude Code | | /upgrade | 大开升级页面 | | /privacy-settings | 稽察和更新阴事缔造（Pro/Max 可用） | | /heapdump | 导出 JavaScript 堆快照，会诊高内存使用 | | /feedback [report] | 提交反馈。笔名：/bug | | /setup-bedrock | 建树 Amazon Bedrock（需 CLAUDE_CODE_USE_BEDROCK=1） | | /setup-vertex | 建树 Google Vertex AI（需 CLAUDE_CODE_USE_VERTEX=1） | | /reload-plugins | 从头加载统共活跃 plugins，无需重启 | 已移除的号召： | 号召 | 讲明 | | ---

四、中枢架构想法1. CLAUDE.md — 合手久高下文详见「七、CLAUDE.md 长远」。

2. Skills — 可重用使命流添加可重用的常识和可调用的使命流。

3. MCP — 外部劳动邻接将 Claude 邻接到外部劳动和器具，相通调用外部接口。

4. Subagents — 阻隔高下文子代理在 阻隔的高下文 中运行我方的轮回，处理完成后复返节录给主 agent。 特色： 有独处的施行环境，不占用主 agent 的高下文恰当处理相对独处但又复杂用功的任务处理完后将精简驱散复返主 agent处置大模子在复杂任务中因高下死不自新长导致的难得力散布、信息遗漏和性能下落问题使用方式： 需要事前手动创建 Subagents创建完成后，后续会话中恰当触发条款的任务会 自动调用 对应的 Subagent，无需每次手动指定自动触发的后果高度依赖创建时的建树质料，并非统共场景都能 100% 可靠触发5. Agent Teams — 多会话融合融合多个独处会话，世界杯比赛买输赢(中国)2026最新官方网站具有分享任务和点对点音书传递。

| 施行 | 单会话内的任务托付，驱散单向复返主对话 | 多个物理独处的会话并走时行 | | 通讯方式 | 单向文书 | 分享任务列表 +

6. Hooks — 生命周期钩子在生命周期事件上触发，可运行剧本、HTTP 苦求、请示或 subagent。相配于钩子函数，100% 会触发 。

7. Plugin — 插件包一个包含特定功能的 压缩包 ，把 Skills + Agents + Commands + Hooks 打包在一齐。中枢价值：复用与分享 。

*** Skills 的高下文本钱讲明：仅在使用时才加载圆善内容，日常苦求只要耗形色部分的 token。

C 七、CLAUDE.md 长远1. 双悲伤系统Claude Code 有两个互补的悲伤系统，两者都在每次对话起始时加载 ：

| CLAUDE.md 文献 | Markdown 文献，为 Claude 提供合手久指示，每个会话起始时读取 | | Claude 自动悲伤 | Claude 主动识别出"值得经久保留的更正和偏好"，不是每一句对话都记 | 自动悲伤记载的两类内容： | 类型 | 讲明 | 示例 | | ---

| 更正 | 你考订了 Claude 的作念法 | "分辨，这里应该用 log.error，不要用 print" | | 偏好 | 你告诉它你但愿永久投诚的编码方式 | "以后所稀有据库操作都用 LambdaWrapper 而不是 updateById" |

2. 导入其他文献CLAUDE.md 文献可使用 @path/to/import 语法导入其他文献。 规矩： 导入的文献在启动时伸开并加载到高下文中，与援用它们的 CLAUDE.md 一齐允许 相对旅途 和 皆备旅途相对旅途相关于 包含导入的文献 知道，而不是使命目次导入的文献不错 递归导入 其他文献，最大深度为 5 跳示例： 联系情势概括，请参阅 @README

联系此项主义可用 npm 号召，请参阅 @package.json

# 其他指示

- git 使命流 @docs/git-instructions.md

3. .claude/rules/ 目次组织规矩在项主义 .claude/rules/ 目次中甩掉 markdown 文献，每个文献应涵盖 一个主题 ，使用形色性文献名。 规矩： 统共 .md 文献都被 递归发现可将规矩组织到子目次中（如 frontend/ 、 backend/ ）规矩在 每个会话 或 大开匹配文献时 加载到高下文中关于不需要永久在高下文中的特定任务指示，改用 Skills （仅在调用时或 Claude 判定联系时加载）目次结构示例： your-project/

├── .claude/

│ ├── CLAUDE.md # 主情势指示

│ └── rules/ │ ├── code-style.md # 代码情势指南

│ ├── testing.md # 测试商定

│ └── security.md # 安全要求

4. 特定旅途的规矩（paths 字段）规矩不错使用 YAML frontmatter 中的 paths 字段范围扬弃到 特定文献 。这些条款规矩仅在 Claude 处理与指定模式匹配的文献时适用。 莫得 paths 字段的规矩 ：无条款加载，适用于统共文献。 旅途匹配模式： | 模式 | 匹配范围 | | ---

| /*.ts | 任何目次中的统共 TypeScript 文献 | | src//*

| .md | 情势根目次中的 Markdown 文献 | | src/components/.tsx | 特定目次中的 React 组件 |

YAML 示例： ```yamlJava paths: - "src/api/*/.java"> 难得：旅途范围规矩在 Claude **读取与模式匹配的文献时触发**，而不是在每次器具使用时。

### 5. 用户级规矩

`~/.claude/rules/` 中的个东说念主规矩适用于你机器上的**每个情势**。用于处理**非情势特定的偏好**。

**加载礼貌：** 用户级规矩在情势规矩**之前加载**，情势规矩领有**更高优先级**。

### 6. 自动悲伤建树

**开关适度：**

**存储位置：**

- 每个情势在 `~/.claude/projects//memory/` 得到我方的悲伤目次

- 可在用户缔造 `~/.claude/settings.json` 中自界说旅途：

```json

{

"autoMemoryDirectory": "~/my-custom-memory-dir"

}

值必须是皆备旅途或以 ~/ 开端。 加载限定： MEMORY.md 的前 200 行 或前 25KB （以先到者为准）在每次对话起始时加载超越该阈值的内容在会话起始时 不加载浏览不断： 运行 /memory 并遴荐自动悲伤文献夹来浏览 Claude 保存的内容一切都是纯 markdown，可读取、剪辑或删除7. CLAUDE.md 文献层级| 文献位置 | 作用 | 讲明 | | ---

| ~/.claude/CLAUDE.md | 主文献夹 | 适用于统共 Claude 会话 | | ./CLAUDE.md | 情势根目次 | 检入 git，与团队分享 | | ./CLAUDE.local.md | 情势根目次 | 个东说念主情势特定条记，添加到 .gitignore 不与团队分享 |

八、使命流最好实践1. Plan Mode 启动方式claude --permission-mode plan

3. 给 Claude 明确的高下文Claude 不错推断意图，但 不可读心术 。建议：

援用特定文献（用 @ 援用）明确说起阻挡条款指出示例模式九、目次结构参考1. 全体架构：情势级 + 用户级Claude Code 的建树分为两个层级：

| 情势级 | 情势根目次 .claude/ | 仅当前项生疏效，可提交 git 与团队分享 | | 用户级（全局） | ~/.claude/ | 统共情势通用，存放个东说念主偏好 |

2. 情势级目次结构（ .claude/ ）your-project/

├── .claude/

│ ├── CLAUDE.md # 情势规矩与合手久高下文

│ ├── .mcp.json # MCP 外部劳动邻接建树

│ ├── .worktreeinclude # 开辟分支创建时的文献复制清单

│ ├── settings.json # 情势分享缔造（权限、环境变量、模子）

│ ├── settings.local.json # 个东说念主障翳缔造（不提交 git）

│ ├── rules/ # 条款触发的规矩文献（按主题分文献）

│ ├── skills/ # 可复用的手段（/手段名 调用）

│ ├── commands/ # 快捷号召封装（比 skills 更肤浅）

│ ├── output-styles/ # 呈报体式模板

│ ├── agents/ # 情势级 subagent 界说文献

| CLAUDE.md | 情势规矩和合手久高下文，每次会话起始加载。建议 ≤200 行 | | .mcp.json | 建树外部劳动邻接（数据库、API、部署器具等） | | .worktreeinclude | 创建 git worktree 分支时需复制的建树文献清单 | | settings.json | 情势基础缔造，团队共用 | | settings.local.json | 个东说念主障翳缔造，不提交 git | | rules/ | 按主题分文献的条款规矩，联系话题出刻下按需加载 | | skills/ | 封装尺度经由的手段卡片，/手段名 调用 | | commands/ | 封装单一操作的快捷号召 | | output-styles/ | 适度 Claude 输出体式（列表、法子等） | | agents/ | subagent 界说文献（如 code-reviewer.md） | | agent-memory/ | subagent 的经久悲伤（如 code-reviewer/MEMORY.md） |

3. 用户级目次结构（ ~/.claude/ ）~/.claude/

├── CLAUDE.md # 跨情势通用步履准则

├── settings.json # 全局基础缔造（权限、环境变量、模子）

├── settings.local.json # 个东说念主偏好障翳

├── rules/ # 通用规矩库

├── skills/ # 全局手段

├── commands/ # 全局号召

├── output-styles/ # 长入呈报作风

├── agents/ # 跨情势可复用的 subagent

├── agent-memory/ # subagent 跨情势悲伤

├── projects//memory/ # 各情势自动悲伤

├── keybindings.json # 键盘快捷键建树

├── themes/*.json # 自界说神态主题

| ~/.claude.json | 中枢状况存储：登录左证、UI 缔造、插件列表 | 切勿手动删除 | | keybindings.json | 自界说键盘组合键 | -

| themes/*.json | 自界说神态主题 | -

| projects//memory/ | 各项主义自动悲伤条记 | 纯 markdown |

4. 运行时临时数据Claude 使命时自动生成，默许 30 天后自动计帐 ：

| projects//.jsonl | 圆善对话记载 | | projects///tool-results/ | 器具输出驱散（过大时单独存储） | | file-history// | 修改文献前的备份快照（用于检查点收复） | | plans/ | Plan Mode 生成的任务解析草稿 | | debug/ | 调试日记（仅开启调试时生成） | | paste-cache/、image-cache/ | 粘贴内容和图片缓存 | | session-env/ | 当前会话环境元数据 | | tasks/ | 当前会话任务列表 | | shell-snapshots/ | 号召行环境快照 | | backups/ | ~/.claude.json 更新前的技术戳备份 | 不会自动删除的数据： | 数据 | 讲明 | | ---

| history.jsonl | 统共请示词历史（按 ↑ 键回忆） | | stats-cache.json | 团聚使用统计（/usage 展示） | | todos/ | 旧版任务列表（已毁灭，可安全删除） |

5. 数据计帐# 官方保举计帐号召

claude project purge [参数]

TypeScript 十、Subagents 实操指南1. 创建 Subagent 的法子在 Claude Code 中运行 /agents切换到 Library 选项卡 → Create new agent → Personal （保存到 ~/.claude/agents/ ，统共情势可用）遴荐 Generate with Claude ，形色 subagent 的功能遴荐器具 ：只读审查者取消遴荐除 Read-only tools 除外的统共内容；保合手全选则接受主对话的统共器具遴荐模子 ：如 Sonnet（分析代码模式的智力与速率均衡）遴荐神态 ：为 subagent 遴荐配景神态，便于在 UI 中识别建树内存 ：决定 subagent 是否在对话中积存观点，不需要则选 None2. /agents 不断界面| 选项卡 | 功能 | | ---

径直在磁盘上添加/剪辑 subagent 文献后需 重启会话 才能加载；通过 /agents 界面创建的则 立即收效 。

4. Subagent 文献体式---

description: Reviews code for quality and best practices tools: Read， Glob， Grep model: sonnet ---

You are a code reviewer. When invoked， analyze the code and provide specific， actionable feedback on quality， security， and best practices.

5. 适度 Subagent 智力通过 tools （允许列表）或 disallowedTools （拒却列表）适度：

# 允许列表：只可读取和搜索

---

description: Research agent with restricted capabilities tools: Read， Grep， Glob， Bash ---

# 拒却列表：接受统共器具，但退却写入和剪辑

---

description: Inherits every tool except file writes disallowedTools: Write世界杯比赛买输赢(中国)2026最新官方网站， Edit ---