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 个最新反应到剪贴板。有代码块时表现交互式聘用器，米兰app2026世界杯中国官网按 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 — 多会话和调解谐多个安逸会话，亚搏yabo(中国)具有分享任务和点对点讯息传递。

| 实践 | 单会话内的任务奉求，终结单向复返主对话 | 多个物理安逸的会话并交运行 | | 通讯方式 | 单向文告 | 分享任务列表 +

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亚搏yabo(中国)， Edit ---