提供 AI 工具指南和内容的频道，以及如何利用它们进行开发：https://t.me/claudedevolper

想象这样一个情景：你对 Claude 说：
「PAYMENT-4521，从 Jira 获取描述，创建分支并实现」。Claude 通过 MCP 拉取任务，读取描述，创建 feature/PAYMENT-4521 分支并开始写代码。你去吃饭，但之前通过 /remote-control 命令在 Claude.ai 中切换了会话。现在 Claude 直接在你的机器上工作，而你可以从手机上观察进度，必要时确认关键操作。到你回来的时候：

  • 代码已经写好了，
  • 子代理进行了代码审查，
  • 更改已推送，
  • Pull Request 已打开。

你写道：「查看评论，适当修复，回复并将任务转移到审查中」。
Claude 自动完成一切：修改代码、推送更新、在工单中回复、更改任务状态。你只需倒杯咖啡。Claude Code 冰山：从基础技巧到高级技术我收集了关于使用 Claude Code 的最实用的实践建议，并以「冰山」的格式组织。这是一种方便的内容呈现方式：

  • 顶部——几乎所有至少运行过一次 Claude Code 的人都知道的内容。
  • 越深入——这些技巧越罕见，它们对开发方法的改变也越深刻。

这篇文章对谁有帮助：
已经尝试过 Claude Code 或计划开始使用它的开发者和团队负责人。所有示例都是真实的、可以直接使用。你可以立即复制并应用到自己的项目中。冰山内部有什么（接下来将讨论各个层级：表面、水下部分、深度等）

第 1 层：冰山顶部

这些是 Claude Code 的基本功能，几乎所有人都从这里开始。如果你刚安装好工具——就从这里开始吧。1.1. 提出问题并生成代码
Claude Code 在终端中作为完整的聊天工具运行。你可以请它解释代码、生成新功能或重写现有代码。同时，Claude 可以看到整个项目——无需将文件复制到浏览器中。流行 IDE 的扩展也在积极推出。请求示例：

  • 「解释 PaymentService 类做了什么」
  • 「为 OrderService 中的 calculateTotal 方法编写单元测试」

1.2. /help 命令
至少运行一次。该命令输出所有斜杠命令的完整列表及简要说明。如果你还不清楚工具的功能，这是最好的参考。1.3. /clear 命令——从零开始
每个对话都会积累历史。切换到新任务时，旧的上下文可能会妨碍你。/clear 命令完全重置历史记录并释放上下文窗口。1.4. @file 语法
——精确指定文件
默认情况下，Claude 可以看到整个项目，但有时会混淆相似的文件名。@file 语法将所需的文件显式加载到上下文中。示例：查看 @src
/main/java/com/example/payment/PaymentService.java 并找出潜在的 bug

1.5. 如何正确表述请求
请求越精确——结果越好。避免「做得更好」这样模糊的措辞。明确指定具体的改动、原因、限制和期望结果的示例。好的请求：在 PaymentService 中重写 processPayment 方法：— 用 Strategy 模式代替 if-else 链 — 将每个策略提取到单独的类中 — 在选择策略时通过 slf4j 添加 INFO 级别的日志

1.6. /remote-control（或 /rc）——从手机控制
此命令通过 claude.ai 网络界面和移动应用程序使当前会话可访问。你可以从终端继续工作，同时从手机上观察和发送命令。

第 2 层：水线

许多人已经熟悉这些技巧，但系统地使用它们的人并不多。掌握这个层级会将 Claude Code 从「智能自动补全」转变为真正的工作伙伴。2.1. CLAUDE.md——永久项目上下文
在项目根目录创建 CLAUDE.md 文件——这是向 Claude 提供关于技术栈、约定、架构和规则信息的方式。启动时会自动读取。有三个级别：

  • 全局（~/.claude/CLAUDE.md）——你的个人偏好，
  • 项目级（./CLAUDE.md）——团队约定，
  • 本地（CLAUDE.local.md）——不会提交到 git 的设置。

/init 命令可以自动生成基本的 CLAUDE.md。2.2. /compact——手动压缩上下文
在长会话中，上下文会填满，模型开始「遗忘」重要细节。/compact 命令允许你手动压缩历史记录，指定需要关注的内容。可以启用自动压缩：claude config set autoCompact true。2.3. /model——即时切换模型
允许在会话中在 Haiku、Sonnet 和 Opus 之间切换。还有 /model opusplan 模式——Opus 规划，Sonnet 执行。2.4. 上下文管理——关键技能
答案质量在很大程度上取决于上下文中有多少有用信息和多少噪声。基本规则：

  • 仅通过 @file 传递需要的文件
  • 切换任务时使用 /clear
  • 规划后（Opus），将已完成的计划与清洁的上下文交给执行者（Sonnet）

2.5. --continue 和 --resume——使用保存的会话
Claude Code 在本地保存所有会话。--continue 加载当前文件夹中的最后一个会话，--resume 允许按名称或 ID 选择任何会话。

第 3 层：水下

这里开始的技巧已经显著区分了有经验的 Claude Code 用户和新手。每一项都能在实际任务中节省真正的时间。3.1. 子代理和并行工作——最强大的工具之一。与其让 Claude 按顺序处理一个大任务，不如将其分解为并行流。示例：发布前需要对 40 个 Java 类进行安全审计。
一个代理需要花大约一小时。使用子代理，Claude 将文件分成 8 组，并行运行 8 个代理，主代理收集最终报告。时间减少到 10-12 分钟。子代理是一次性的——它们执行一项任务然后完成。它们可以链接在一起并互相调用。提示示例：我需要将 @src
/test/kotlin 中所有从 Kotlin 转写为 Java 的测试。
使用子代理：按包划分工作，每个代理处理自己的组。

3.2. 用户自定义子代理 除了内置的，还可以创建自己的专业化代理。 例如：代码审查代理。创建文件 .claude/agents/reviewer.md： markdown

---
name: reviewer
description: Проводит код-ревью изменений
tools: Read, Glob, Grep
model: sonnet
maxTurns: 10
---

Ты — опытный ревьюер Java-кода. Проанализируй изменения и дай замечания только по:
- корректности логики
- обработке ошибок
- производительности
- соответствию принятым конвенциям

Не предлагай косметические правки. Фокусируйся на реальных проблемах.

之后，当上下文适合时，Claude 将自动将审查任务委托给这个子代理。 可以在以下仓库中找到现成的子代理：Awesome Claude Agents、wshobson/agents 和 Subagents.cc。 3.3. 现成的命令、代理和 skills 不要重新发明轮子。在编写自己的代理或命令之前，先在开放目录中寻找现成的解决方案。通常有人已经做过了您需要的东西。 好的起点是相同的子代理仓库加上在 GitHub 上的常规搜索："claude agents"、"claude commands"、"claude skills"。 3.4. /fork — 分支会话 当需要尝试多种解决方案时，这是一个非常有用的命令。 例如：您花费 20 条消息调试了一个复杂的 bug。上下文已经很好了。现在想尝试两种不同的修复方法。只需执行 /fork via-chain，打开第二个终端，在其中尝试备选方案。两个 Claude 都使用相同的历史记录，但在同一个项目目录中。 如果需要完全隔离代码，请使用 git worktrees。 3.5. /rewind — 回滚会话和文件 /rewind（或 /checkpoint）命令允许您返回到会话的任何以前的时间点。Claude 存储通过其工具所做的所有更改的历史记录，可以回滚对话和文件。 在单个会话中进行实验时，这比 git reset 方便得多。 重要提示：仅会滚回通过 Claude 所做的更改。IDE 或 bash 中的手动编辑不受 /rewind 影响。 3.6. /add-dir — 使用多个目录 默认情况下，Claude 仅适用于当前文件夹。/add-dir 命令允许您连接其他目录（例如，共享库、单独的模块，甚至另一个存储库）。 在使用 monorepo 时或需要同时编辑 API 契约及其实现时很有用。

级别 4：深层

在此级别，Claude Code 开始作为您团队的一部分工作，而不仅仅是助手。 4.1. Hooks（钩子）— 自动操作 Hooks 允许在特定事件发生时自动运行 shell 命令（文件保存后、提交前等）。 最有用的场景：

  • 每次更改后自动格式化代码（Prettier、Spotless 等）
  • 运行 linter
  • 禁止直接提交到 master/main
  • 修复后自动运行测试

通过 Prettier 进行自动格式化的示例： json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\""
      }
    ]
  }
}

4.2. MCP 服务器 — 连接外部系统 MCP（模型上下文协议）是一个开放协议，可以将 Claude Code 转变为真实的中心。通过它可以连接 Jira、Confluence、Bitbucket、Sentry、数据库和任何其他 API。 连接后，您可以编写形式如下的请求： 查找项目 PAYMENT 在最后一周内的所有关键 bug 获取任务 PAYMENT-4521 并按其描述实现

Claude 将自动从 Jira、Sentry 等提取数据。 与 Sentry 结合时特别方便："查看 payment-service 中的最新错误并提出修复方案"。

4.3. 路由规则（.claude/rules/） 允许您通过 glob 模式为特定文件类型设置约定。仅在处理匹配文件时将指令加载到上下文中，节省令牌并使规则更精准。 在大型项目和 monorepo 中很有用，其中不同的模块遵循不同的标准。

4.4. 权限模式和 /permissions Claude Code 具有灵活的权限系统。可以在模式之间切换（default、plan、acceptEdits、bypassPermissions），并配置操作白名单。

4.5. /doctor — 问题诊断 遇到任何无法理解的错误时的第一个命令。检查版本、API 连接、MCP 服务器状态和访问权限。

级别 5：深渊

这是严肃自动化、自定义代理和几乎完全自主性的领域。大多数开发者甚至不会涉足这里，但正是在这个级别，Claude Code 从便利的助手转变为真正的工程流程的一部分。 5.1. 用户自定义 slash 命令 标准化团队中重复操作的最简单方法。 在 .claude/commands/ 中创建文件，将其提交到 git，现在整个团队可以使用相同的命令。 示例：预发布检查 文件 .claude/commands/deploy-check.md：

Выполни предрелизную проверку:

1. Запусти `./gradlew build` и убедись, что сборка проходит успешно
2. Проверь все тесты: `./gradlew test`
3. Убедись, что нет незакоммиченных изменений (`git status`)
4. Проверь, что текущая ветка — не master/main
5. Выведи сводку: статус сборки, количество пройденных тестов, текущая ветка

Если есть проблемы — дай чёткий список рекомендаций по исправлению.

现在只需输入 /deploy-check，就能获得统一的报告。 对于带参数的命令，使用占位符 $ARGUMENTS： 示例：文件 .claude/commands/explain-class.md

Найди класс $ARGUMENTS в проекте и подробно объясни:
- его назначение и роль в архитектуре
- основные зависимости и кто его использует
- потенциальные проблемы и технический долг

Результат оформи в структурированном виде.

5.2. Skills — 可重用的提示模板 Skills 是用户自定义命令之后的下一个级别。它们旨在嵌入到代理场景中，可以通过编程调用、在代理之间传递，并链接在一起。 这个话题相当广泛，值得单独撰写一篇文章，但重点是这种机制存在，大大简化了团队内复杂提示的重用。 5.3. Claude Agent SDK 对于想要将 Claude Code 功能集成到自己的工具中的人，存在官方的 Claude Agent SDK（提供 Python 和 TypeScript）。 有了它，可以通过编程创建代理、管理其生命周期、连接工具和处理结果。 典型场景：

  • 使用自定义逻辑的自动代码审查
  • CI/CD 中的智能错误分析
  • 具有代码库访问权限的开发人员内部聊天机器人
  • 自动安全和代码风格审计器

5.4. Pipe 模式和 headless 模式 — Claude Code 在脚本和 CI/CD 中 Claude Code 不仅可以交互式使用，还可以用于自动化。

  • 管道输入——通过 stdin 传递数据
    cat PaymentService.java | claude "查找并发访问问题"
  • 打印模式 (-p)——非交互式输出
    claude -p "解释 processRefund 方法"
  • 结构化 JSON 输出——非常适合与 CI/CD 集成以及通过 jq 进行解析。

自动 PR 审查示例：bash

git diff origin/master...HEAD | claude -p \
  "Проведи код-ревью этого diff. Укажи баги, проблемы безопасности и нарушения конвенций. Формат: markdown." \
  --output-format json > review-result.json

PR 描述生成示例：bash

claude -p "на основе git log и diff сгенерируй описание PR в формате markdown" > pr-description.md

总结

大多数开发人员停留在第 1-2 级，并将 Claude Code 用作高级自动补全。真正的价值从第 3 级开始，并在第 4-5 级完全显现——当工具不再与你并行工作，而是开始与你的流程协同工作时。Claude Code 不仅仅是「又一个终端中的 AI」。正确使用时，它会成为一个真正的团队成员，懂得规划、委派、遵守你的规则并全天候工作。哪个级别给你的启发最大？
你经常使用哪些技巧，又是在读完这篇文章后才第一次尝试的？

在评论中写下来——很想看看哪些模式已经在真实的团队中扎根。

claude code 指南和内容频道——分享新闻（当限制被削减 10 倍时）以及我们通过 claude 为项目实现的工具。频道：https://t.me/claudedevolper