用 Claude Code 泰半年了，踩过的坑比写过的代码还多。一早先我以为 Claude Code 便是一个"更高档的 Copilot"——在末端里打字，它帮我写代码，完事。自后才发现，这东西的上限远比我想象得高，但前提是你得知谈怎样用。 这篇著作联结官方文档和实战阅历，整理了我以为最紧要的使用手段。有些是啜泣老师，有些是读文档才知谈的笼罩功能。
一、CLAUDE.MD：最被低估的功能若是你只记取这篇著作的一件事，就记这个：写好你的 CLAUDE.md。 CLAUDE.md 是 Claude Code 在每次对话早先时自动读取的指示文献。它就像你给一个新共事写的 onboarding doc——你但愿他知谈什么，你就写什么。
许多东谈主不写 CLAUDE.md，能够平淡写两行。拆伙便是每次对话齐要重新证明名堂结构、编码表率、工夫栈聘用。这就像每天早上齐要再行给同预先容一遍公司。
一个好的 CLAUDE.md 应该包含什么
markdown
# 名堂称号
## 构建和测试大呼
- 装置依赖：npm install
- 运行测试：npm test
- 单个测试：npm test -- --grep "test name"
- 时势化：npm run format
## 编码表率
- Python 使用 ruff 时势化，行宽 88
- 测试用 pytest，每个 service 对应一个测试文献
- API 路由文献名用复数：users.py， orders.py
- 提交信息用英文，时势：type(scope): description
## 架构决策
- 选 Tailwind 而不是 CSS Modules，因为团队调理了这个表率
- 用户权限校验在 middleware 里作念，不要在每个路由重迭写
- Redis 缓存的 key 前缀调理用 `app:v1:`
## 常见陷坑
- 数据库团结池上限是 20，别在轮回里开新团结
- 不要 mock 数据库，前次 mock 测试通过但分娩迁徙失败了有几个关节原则： 第一，写 Claude 从代码里读不出来的东西。 名堂的"为什么"比"是什么"更紧要。你不需要证明 React 怎样用，但你需要告诉它"咱们选 Tailwind 是因为团队调理了这个表率"。 第二，操纵在 200 行以内。 官方文档明确提到，CLAUDE.md 太长会导致 Claude 忽略礼貌。用 markdown 标题和列表，保捏可扫描性。 第三，不要放频繁变化的推行。 详备的 API 文档、逐文献描画这些东西不顺应放在 CLAUDE.md 里。放无间就好。
CLAUDE.md 的四级层级Claude Code 搭救四级 CLAUDE.md，按优先级从高到低：
我的全局 CLAUDE.md 里平淡会写：
- 我是别称全栈工程师，不需要过度证明基础见识 - 回应尽量简易，不要加无关的客套话 - 代码改变后不要纪念你作念了什么，我会看 diff - 优先用浅近决策，不要过度工程
这四行，能省却你几百次重迭创新的时候。
进阶：用 .claude/rules/ 组织礼貌
当名堂大了之后，一个 CLAUDE.md 文献塞不下总共礼貌。官方提供了一个更优雅的决策：把礼貌拆到 .claude/rules/ 目次下。 .claude/rules/ ├── testing.md # 测试表率 ├── api-style.md # API 编写稿风 └── frontend.md # 前端商定
更强劲的是，你可以用 YAML frontmatter 把礼貌放纵到特定文献：
--- paths: ["src/api/**/*.ts"， "src/routes/**/*.ts"] --- API 路由必须包含输入考据和失实处理。 总共新端点需要在 tests/api/ 下添加集成测试。
这样这条文矩只在 Claude 走访匹配的文献时才会加载，简约迂回文空间。
二、教导词的质地决定产出的质地这听起来像空话，但我见过太多东谈主这样用 Claude Code：
"帮我写一个登录功能"
然后对着生成的一大坨代码发愁——这不是我想要的啊。 好的指示应该包含三个因素：计算、贬抑、迂回文。 差的指示 vs 好的指示
差："给用户列表加个搜索功能"
好："在
@src/pages
/UserList.tsx 的表格上方加一个搜索框。搜索走后端 API /api/users?search=xxx，不要前端过滤。用 debounce 300ms，神情和现存的 Filter 组件保捏一致。"
区别在哪？好的指示减少了歧义。Claude Code 不需要猜你要前端搜索照旧后端搜索，不需要猜 debounce 时候，不需要猜神情表率。
官方保举的教导手段 1. 用 @ 援用具体文献 Claude Code 搭救用 @文献旅途 凯旋把文献推行拉进迂回文。比起说"阿谁认证干系的代码"，凯旋写
@src/auth
/login.ts 精准得多。你以致可以指定行号范畴：
@src/auth
/login.ts#5-30。 2. 贴截图和图片 用 Ctrl+V 可以凯旋粘贴图片。调试 UI 问题时，贴一张"目下长这样"和"我想要这样"的截图，比翰墨描画灵验十倍。 3. 给考据圭表 不要只说"帮我修这个 bug"，而是：
"成立登录超时后无法再行认证的问题。成立后，用户在 token 过期后点击放荡按钮应该自动跳转到登录页。测试用例在
@tests/auth
.test.ts 里，修完后跑一下说明通过。" 给 Claude 一个可以自我考据的圭表——测试用例、截图、预期输出——它就能我方检验职责质地，减少往返修改。 4. 明确"不要作念"的事 Claude Code 偶然候会过度热心——你让它修一个 bug，它顺遂把周围的代码也重构了。明确说"只改这个函数，不要动其他代码"，能省许多事。
平淡指示也有用武之地
并不是总共时候齐需要精准的指示。探索性任务用平淡指示反而更好： "这个文献有什么可以创新的场所？""帮我意会一下这个模块的架构""这段代码有什么潜在问题？"但到了终了阶段，切回精准模式。
三、PLAN MODE：先想明晰，再动手Claude Code 有一个 Plan Mode，这是我以为最被低估的职责流。
怎样进入 Plan Mode
三种方式：
# 启动时凯旋进入 claude --permission-mode plan # 对话中切换（按两次 Shift+Tab） Shift+Tab Shift+Tab # 在教导词里说 "先不要改代码，帮我作念个计算"
在 Plan Mode 下，大阳城(SuncityGroup)Claude Code 只可读取文献、搜索代码，不成作念任何修改。它会探索代码库，分析你的需求，然后给出一个详备的终了计算。
Plan Mode 的正确翻开方式
关节操作：按 Ctrl+G 可以在你的剪辑器里翻开并剪辑计算。 这意味着你可以：
让 Claude 生成驱动计算Ctrl+G 翻开计算，删掉你不本旨的部分，补充你我方的主义切回正常模式（Shift+Tab），让 Claude 按修改后的计算实行改一个计算只需要一句话，改也曾写好的代码要花十倍的时候。 保举的复杂任务职责流
官方保举的圭表历程是四步：探索 → 盘算 → 终了 → 考据。 1. 进入 Plan Mode 2. 让 Claude 阅读干系代码："读一下 src/auth/ 下的代码，意会 session 处理逻辑" 3. 申请计算："制定一个 OAuth2 迁徙决策" 4. Ctrl+G 审查和剪辑计算 5. 切回正常模式 6. "按照计算终了，写完跑测试" 7. 让 Claude 对照需求自查
什么时候不需要 Plan Mode
改一个变量名修一个赫然的 typo加一溜日记判断圭表很浅近：若是这个任务的终了方式惟有一种，凯旋作念。若是有多种聘用，先盘算。 四、子 AGENT：CLAUDE CODE 的分身术子 Agent 是 Claude Code 的一个强劲机制——它可以启动落寞的 AI 程度来并行处理任务，每个子 Agent 有我方的迂回文窗口，不会浑浊你的主对话。
内置的子 Agent 类型 类型能力用途Explore只读，快速搜索代码库探索、找文献、找界说Plan只读，权衡分析Plan Mode 下的代码分析General完整能力复杂的多门径任务
子 Agent 最大的价值：阻遏迂回文
当你让 Claude 跑测试、分析日记、搜索普遍文献时，这些操作会产生海量输出，塞满你的迂回文窗口。用子 Agent 来作念这些事，输出留在子 Agent 的迂回文里，ued(中国)官方网站入口惟有纲目复返给你。 比如：
"用子 Agent 跑一下全量测试，把失败的用例列出来"
"用子 Agent 搜索总共使用了 deprecated API 的文献"
后台运行：Ctrl+B
按 Ctrl+B 可以把子 Agent 放到后台运行。你可以无间和 Claude 聊其他事，等后台任务完成后会自动示知你。
顺应：
跑测试套件（平淡需要几分钟）大范畴代码搜索不迫切的代码审查自界说子 Agent
你可以在 .claude/agents/ 目次下创建自界说 Agent：
--- name: code-reviewer description: 代码审查群众。代码改变后自动触发。 tools: Read， Grep， Glob， Bash model: sonnet --- 你是一位资深代码审查者。检验以下维度： - 代码澄莹度和可读性 - 失实处理是否完整 - 有莫得露出明锐信息 - 输入考据 - 性能隐患
然后在对话顶用 @"code-reviewer (agent)" 调用它。
五、迂回文治理：最容易被残忍的关节Claude Code 的迂回文窗口诚然大（最多 1M token），但它不是无尽的，何况迂回文治理凯旋决定了输出质地。 迂回文里齐装了什么
你的对话历史Claude 读取的总共文献推行大呼实行的输出CLAUDE.md 文献（每次齐加载）Memory 文献（前 200 行）加载的 Skill 和 MCP 器用界说五个实用计谋 1. /clear ：一件事作念完就清 不要在吞并个对话里又修 bug 又加功能又重构。/clear 会清空迂回文但保留 CLAUDE.md，特等于一次免费的重启。 2. /compact ：手动压缩迂回文 当对话变万古，输入 /compact 让 Claude 自动纪念和压缩之前的对话。更好的用法是给压缩加一个焦点：
/compact 专注于 API 改变和测试拆伙
这样 Claude 在压缩时会优先保留你温雅的推行。 3. /context ：望望迂回文被谁吃了 输入 /context 可以看到刻下迂回文的使用情况——哪些文献占了几许 token，MCP 器用界说占了几许。我平淡发现一些没用的 MCP server 占了普遍空间。 4. 用子 Agent 阻遏噪声 跑测试、分析日记这些操作会产生普遍输出。让子 Agent 去作念，主对话的迂回文保捏干净。 5. 在 CLAUDE.md 里写压缩保留指示 你可以告诉 Claude 压缩时必须保留什么：
# 压缩指示 压缩迂回文时，恒久保留： - 已修改文献的完整列表 - 测试大呼和拆伙 - 关节的架构决策
Memory vs CLAUDE.md Memory 顺应存什么： 你的偏好（"这个东谈主可爱简易回应"）、名堂商定（"部署有个特殊门径"）、历史决策（"前次选了决策 A 是因为 X"）。 Memory 不顺应存什么： 代码细节、Git 历史、临时现象——这些从代码和 Git 里得到更准确。
用 /memory 大呼可以检讨和治理总共已加载的 Memory。
六、权限治理：安全和恶果的均衡Claude Code 提供了五种权限模式，用 Shift+Tab 在对话中轮回切换：
权限礼貌配置在 .claude/settings.json 里，你可以紧密操纵每种器用的权限：
{ "permissions": { "allow": [ "Bash(npm run *)"， "Bash(git commit *)"， "Edit(src/**/*.ts)"， "Read(*.md)" ]， "deny": [ "Bash(rm -rf *)"， "Edit(.env)" ] } } 礼貌优先级：deny → ask → allow（deny 最优先）。
这意味着你可以斗胆地 allow 常用大呼，同期用 deny 保护明锐文献。比如 .env 文献，无论如何齐不应该被剪辑。
成就文献的层级和 CLAUDE.md 肖似，settings 也有多级：
组织计谋（最高优先级） ↓ CLI 参数 ↓ .claude/settings.local.json（腹地，不提交到 Git） ↓ .claude/settings.json（名堂级，团队分享） ↓ ~/.claude/settings.json（全局，个东谈主） ↓ 默许值（最低优先级）
我的提出：把团队分享的礼貌放 .claude/settings.json，个东谈主偏好放 ~/.claude/settings.json，明锐配置放 .claude/settings.local.json（记起加到 .gitignore）。 七、HOOKS：让礼貌酿成铁律CLAUDE.md 里的指示是"提出"——Claude 大部分时候会死守，但偶尔会忘。Hooks 是"铁律"——无论如何齐会实行。 Hooks 是在特定人命周期事件上自动触发的 shell 大呼。配置在 settings.json 里。
关节事件类型
实用示例 自动时势化——每次剪辑后运行 Prettier： { "hooks": { "PostToolUse": [{ "matcher": "Edit|Write"， "hooks": [{ "type": "command"， "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }] }] } } 保护关节文献——封闭修改分娩配置： { "hooks": { "PreToolUse": [{ "matcher": "Edit|Write"， "hooks": [{ "type": "command"， "command": ".claude/hooks/protect-files.sh" }] }] } }
Hook 大呼复返 exit code 0 示意允许，exit code 2 示意封闭。这意味着你可以写放荡复杂的判断逻辑。 迂回文压缩后再行注入关节信息： { "hooks": { "SessionStart": [{ "matcher": "compact"， "hooks": [{ "type": "command"， "command": "echo '用 Bun 无用 npm。提交前跑 bun test。'" }] }] } }
这贬责了一个常见痛点：对话太长被压缩后，之前提过的紧要指示可能丢失。用 Hook 可以在每次压缩后自动再行注入。
Hook 的四种类型 类型说明command实行 shell 大呼，从 stdin 读取 JSONhttp向 URL 发送 POST 申请prompt单次 LLM 调用，作念 yes/no 判断agent启动一个子 Agent 进行考据
八、GIT 职责流：用好 WORKTREEClaude Code 能实行 Git 大呼，这是一把双刃剑。但官方提供了一个很好的安全网：Worktree。 Git Worktree：阻遏的职责空间
# 在阻遏的 worktree 中启动 Claude claude --worktree feature-auth claude --worktree bugfix-123 # 自动生成名字 claude --worktree
Worktree 会在 .claude/worktrees/ 下创建一个落寞的 Git 分支副本。Claude 在内部怎样折腾齐不影响你的主分支。退出时：
若是莫得改变 → 自动清算若是有改变 → 教导你保留或删除这关于探索性任务特等有用。 不笃定某个重构决策能不成行？开个 worktree 试试，不行就扔掉，零风险。 几个 Git 铁律1. 长期不要让 Claude Code 自动 push 它可以 commit，但 push 这个动作应该由你来说明。一朝 push 到远端，回退资本就大了。 2. 频繁 commit 作念完一个小功能就 commit。用 /rewind 可以回退到放荡一个 checkpoint，但前提是你有 commit 纪录。 3. 警惕遏制性操作 若是 Claude Code 要实行 git reset --hard、git push --force、rm -rf，一定要在脑子里过一遍后果再批准。 这些操作莫得 undo。你也可以在权限礼貌里凯旋 deny 掉这些大呼。 4. 从 PR 收复迂回文 这会自动加载 PR 的改变和商榷行为迂回文，相配顺应 code review 能够无间别东谈主的职责。
claude --from-pr 123
九、快捷键和大呼速查这些快捷键我每天齐在用，激烈提出记取： 最常用的快捷键最常用的斜杠大呼 /compact [焦点] # 压缩迂回文，可指定保留重心 /clear # 清空对话，再行早先 /context # 检讨迂回文使用情况 /memory # 检讨和治理 Memory /rewind # 回退到某个 checkpoint /resume [称号] # 收复之前的对话 /model # 切换模子 /effort [级别] # 成就推理深度：low/medium/high/max /init # 自动生成 CLAUDE.md /mcp # 治理 MCP 处事器 /permissions # 检讨权限礼貌 /cost # 检讨 token 滥用
/init 对新名堂特等有用——它会自动分析你的代码库，帮你生成一个 CLAUDE.md 的初稿。诚然平淡需要手动革新，但比从零早先快得多。
十、EXTENDED THINKING：让 CLAUDE 想深极少关于复杂问题，你可以开启 Extended Thinking 模式，让 Claude 在回答前花更多时候推理。
怎样用# 快捷键切换 Option+T (Mac) / Alt+T (Windows/Linux) # 能够用大呼 /effort high # 更真切的推理 /effort max # 最大推理深度 /effort low # 浅近任务，省 token
什么时候该用复杂的架构决策难办的 debug（多个可能原因需要摒除）多门径的重构决策假想权衡多个决策的好坏什么时候不需要
浅近的代码修改时势化、重定名也曾很明确的 bug 成立小手段： 在教导词里写 ultrathink 可以强制触发最高推理深度，不需要手动革新 effort 成就。
十一、MCP SERVER：让 CLAUDE 团结外部寰球MCP（Model Context Protocol）让 Claude Code 能和外部器用通讯——GitHub、数据库、Slack、Notion 等等。
快速添加claude mcp add github -- npx @anthropic-ai/mcp-server-github claude mcp add postgres -- npx @anthropic-ai/mcp-server-postgres postgresql://localhost:5432/mydb
配置文献
MCP 配置在 .mcp.json 里：
{ "mcpServers": { "github": { "type": "stdio"， "command": "npx"， "args": ["@modelcontextprotocol/server-github"]， "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" } } } }
凝视迂回文支出 每个 MCP server 会颠倒滥用 100-500+ token 的器用界说。 用 /mcp 大呼可以检讨每个 server 的支出，禁用无用的 server。
我的阅历：不要贪多。 常用的 2-3 个 MCP server 就够了。装太多，迂回文空间被器用界说吃掉，反而影响代码分析的质地。
十二、IDE 集成：不仅仅末端VS Code装置 Claude Code 扩展后，你可以在 VS Code 里凯旋使用 Claude，而不需要切到末端。
几个好用的功能： 并列 diff 视图：Claude 的改变以 diff 方式自大，一目了然Option+K / Alt+K：快速插入刻下文献的 @援用多标签对话：在不同的标签页里开多个落寞对话Cmd+Shift+Esc：快速翻开新的对话标签JetBrainsIntelliJ、PyCharm、WebStorm 等 JetBrains 全家桶也有 Claude Code 插件，在 Plugins 市集搜索 "Claude Code" 装置即可。
十三、审查代码：信任但要考据Claude Code 写的代码质地总体可以，但你不成盲目信任。
几个常见问题1. 过度工程 你让它写一个浅近的器用函数，它给你搞出一个完整的综合层，带泛型、带接口、带工场模式。杀鸡用了牛刀。 贬责纪律： 在 CLAUDE.md 里写上"优先用浅近决策"，或在指示里明确说"不需要综合"。 2. 幻觉 API 它偶然候会用不存在的 API 能够落伍的语法。尤其是小众库的新版块。 贬责纪律： 跑测试。这亦然为什么指示里应该包含考据圭表。 3. 改变范畴膨大 你让它改一个函数，它把通盘文献齐重构了。 贬责纪律： 明确说"只改 X，不要动其他代码"。能够用 /freeze 大呼适度剪辑范畴到指定目次。
Writer/Reviewer 模式官方保举的一个高档模式：用两个落寞的会话折柳上演"写代码"和"审查代码"的变装。 两个会话有落寞的迂回文，Reviewer 不受 Writer 的念念路影响，能发现 Writer 的盲点。
会话 A（Writer）："终了 API 限流中间件" 会话 B（Reviewer）："审查 @src/middleware/rateLimiter.ts 里的限流终了， 重心看界限情况、竞态要求、一致性" 会话 A："成立审查响应：[粘贴 B 的输出]"
十四、不要用 CLAUDE CODE 作念的事说了这样多"应该怎样作念"，终末聊聊"不应该作念什么"。 1. 不要让它作念你十足不了解的事 若是你对 Kubernetes 一无所知，不要让 Claude Code 帮你写部署配置然后凯旋用。你无法审查你不懂的东西。 2. 不要在莫得版块操纵的环境下用 莫得 Git 就莫得回退的能力。Claude Code 的改变可能覆盖你的文献，莫得版块操纵便是裸奔。 3. 不要连气儿扔一个广阔的任务 "把通盘名堂从 JavaScript 迁徙到 TypeScript"
这种指示等于让 Claude Code 摆脱进展。拆伙不可控。拆成小门径，每一步说明后再作念下一步。 4. 不要指望一次就无缺 迭代是正常的。用 /rewind 回退，用精准的响应描画"那边不合"。
纪念Claude Code 的中枢使用形而上学其实很浅近： 它是一个极其颖悟的合作家，但不是自动驾驶。标的盘恒久在你手里。 按紧要性排序，我的提出是： 写好 CLAUDE.md — 一次参加，每次对话齐受益给精准的指示 — 计算 + 贬抑 + 考据圭表用 Plan Mode — 复杂任务先盘算再动手治理迂回文 — /clear、/compact、子 Agent操纵权限 — deny 危急操作，allow 常用大呼频繁 commit — 保留回退能力作念到这些，Claude Code 能让你的恶果翻好几倍。作念不到，它只会更快地帮你制造零散。
器用的价值ued中国官网，长期取决于使用它的东谈主。
BG真人(BigGaming)官方网站
备案号: