2026 如何养好 Claude Code（零）：ClaudeCode Basics

10013805030 · 2026 年4 月 15 日 06:06

我们之前介绍了 Claude Code 很多核心的概念和理念，但很多基础的命令操作还没覆盖。基础技巧同样重要，因此增补这一篇。

系列导航：

开篇 · 2026 如何养好 Claude Code（开篇）：从养龙虾到养 Claude Code
第零篇 · 2026 如何养好 Claude Code（零）：ClaudeCode Basics
第一篇 · 2026 如何养好 Claude Code（一）：核心机制深度解析
第二篇 · 2026 如何养好 Claude Code（二）：插件生态深度实践
第三篇 · 2026 如何养好 Claude Code（三）：框架选型指南
第四篇 · 2026 如何养好 Claude Code（四）：多Agent协作实战

快捷键与交互技巧

1. Plan Mode：磨刀不误砍柴工

触发方式：

自动触发：复杂任务（如重构、新功能开发）Claude 会自动进入
手动触发：/plan 命令或按 Shift+Tab 两次

核心价值：
Plan Mode 是只读模式——Claude 可以分析代码库、搜索文件、创建详细计划，但不会修改任何文件。直到你批准后才开始执行。

适用场景：
- 大型重构
- 新功能开发
- 系统性变更

2. 多 Prompt 队列输入

Claude Code 内置了智能队列机制。你可以连续输入多个 prompt，它会自动协调执行顺序。

推荐做法：对于有依赖关系的任务，一次性输入多个指令，让 Claude 自行规划执行顺序。

3. ESC 打断执行

当 Claude 的执行方向偏离预期时：

单次 ESC：打断当前操作，Claude 会停下来等待你的新指令

还有个技巧，可以通过 "”和 ""来切换历史的输入，可以提高输入效率

4. 双击 ESC

清空输入框：当有大量输入想清空时
切换历史会话：在不同会话间快速切换

5. 图像输入

方式	操作
粘贴	`Ctrl+V` / `Cmd+V`
拖拽	直接拖拽图片到终端
MCP	Figma MCP 等设计工具集成

核心命令

/clear

清空当前上下文，开始新任务。

使用场景：上一个任务完成后，清除历史上下文，避免干扰新任务。

/compact

手动触发上下文压缩。

背景：Claude Code 有自动压缩机制，但当你需要主动保存关键上下文时，可以提前使用 compact。

/resume

恢复之前的会话。

会话内使用：运行 /resume 会展示历史的 session 列表，可选择恢复。

CLI 启动方式：

# 交互式选择历史会话
claude --resume

# 恢复指定会话（按名称或 ID）
claude --resume "my-feature-work"

长任务迭代技巧：

结合 --dangerously-skip-permissions 可以在长任务中持续迭代，无需重复确认权限：

claude --dangerously-skip-permissions --resume

注意：--dangerously-skip-permissions 会跳过所有权限确认，请确保在受信任的环境中使用。

更多权限配置详见权限配置要点章节。

/mcp

查看已安装的 MCP 服务器列表。

重要提醒：MCP 使用需要谨慎

Token 消耗数据：

GitHub MCP 单次消耗：~55,000 tokens

5 个 MCP 服务器可消耗：66,000+ tokens

占用 200K 上下文的 27-33%

最佳实践：仅启用必要的 MCP，避免上下文污染

工具延迟加载

Claude Code 可以加载数十个 MCP 工具，但不会在每个请求中包含所有工具：

发送轻量级存根（stubs）：只有工具名称，带 defer_loading: true
模型需要时通过 ToolSearch 工具"发现"它们
只有被选择时才加载完整工具架构

优势：保持缓存前缀稳定 + 降低请求成本

Git 集成技巧

Claude Code 与 Git 深度集成，可以：

功能	示例指令
提交代码	`commit my changes`
创建 PR	`create a pull request`
查看变更	`review git diff`
解决冲突	`resolve merge conflicts`

基本实践：

让 Claude 写 commit message，它比人工写的更规范
使用 --no-verify 前需要明确授权
重要变更建议先 review diff 再提交

Git Hooks 自动化工作流

Git Hooks 是在特定事件（如 commit、push）触发时自动执行的脚本，可以显著优化研发流程。

常用 Hook 类型：

Hook	触发时机	典型用途
`pre-commit`	提交前	格式检查、秘密扫描、快速 lint
`commit-msg`	提交信息验证	格式规范、Ticket ID 检查
`pre-push`	推送前	较慢的测试、类型检查、构建
`post-commit`	提交后	通知、日志记录

速度预算建议：

pre-commit: 1-5 秒
commit-msg: <1 秒
pre-push: 30-90 秒

Claude Code Hooks 进阶用法

Claude Code 提供了更强大的 Hooks 系统，可以在 AI 操作的生命周期中注入自动化逻辑。
Hooks 在第二篇「2026 如何养好 Claude Code（二）：插件生态深度实践」中有详细解释，这里直接介绍如何配置。

核心事件类型：

事件	时机	用途
`PreToolUse`	工具调用前	阻止危险操作、验证参数
`PostToolUse`	工具调用后	自动格式化、日志记录
`Notification`	Claude 等待输入时	桌面通知
`Stop`	Claude 完成响应时	验证任务完成度
`SessionStart`	会话开始时	注入上下文

实用配置示例：

自动格式化代码（PostToolUse）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

保护敏感文件（PreToolUse）

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/protect-files.sh"
          }
        ]
      }
    ]
  }
}

桌面通知（Notification）

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude needs input\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

配置文件位置：

位置	作用范围	可共享
`~/.claude/settings.json`	全局	否
`.claude/settings.json`	项目级	是（可提交）
`.claude/settings.local.json`	项目级本地	否（gitignore）

查看已配置 Hooks：运行 /hooks 命令

最佳实践：

Hooks 应该快速且可预测，避免让开发者等待

失败时提供清晰的错误信息和修复命令

本地 Hooks 是"护栏"而非"强制执行"，CI 才是最终保障

CLAUDE.md 最佳实践

CLAUDE.md 是 Claude Code 读取项目配置的核心文件，每个会话都会加载。

核心原则

1. Less is More

LLM 能可靠遵循的指令数量有限（约 150-200 条）

文件长度：建议 < 300 行，越短越好
指令数量：只放通用性强的指令
避免：把所有可能的命令都塞进去

2. 优先级原则

越重要的内容放越上面。LLM 对文件开头和结尾的内容关注度更高。

3. 渐进式披露（Progressive Disclosure）

不要把所有信息都塞进 CLAUDE.md，而是告诉 Claude 去哪里找：

推荐结构：
agent_docs/
  |- building.md        # 构建说明
  |- testing.md         # 测试指南
  |- architecture.md    # 架构文档

在 CLAUDE.md 中简要列出这些文件，让 Claude 按需读取。

4. 不要用 Claude 做格式化工具

不要在 CLAUDE.md 中写代码风格指南

代码格式化应该交给：

ESLint / Prettier
Biome（推荐，支持自动修复）

技巧：用 Hook 在文件编辑后自动运行 formatter，而不是让 Claude 手动处理格式问题。

5. 不要自动生成 CLAUDE.md

/init 生成的 CLAUDE.md 往往内容冗余、缺乏针对性。

CLAUDE.md 是整个 harness 中杠杆率最高的文件——每一行都会影响所有会话。值得花时间精心设计。

CLAUDE.md 配置层级

在团队协作中，可能会遇到一个问题：每个人 clone 同一个项目后，Claude Code 的行为却不太一致。原因在于——配置是有层级划分的。

graph TB
    subgraph 配置层级["CLAUDE.md 配置层级"]
        A["User 层级<br/>~/.claude/CLAUDE.md"]:::user
        B["Project 层级<br/>./CLAUDE.md"]:::project
        C["Local 层级<br/>./CLAUDE.local.md"]:::local
    end
    A --> B --> C
    classDef user fill:#7B9EC8,stroke:#5a8ab8,color:#fff
    classDef project fill:#7BA17B,stroke:#5a8a5a,color:#fff
    classDef local fill:#D4A574,stroke:#b8905a,color:#fff

层级	路径	职责	Git
User	`~/.claude/CLAUDE.md`	个人偏好（语言、风格）	不提交
Project	`./CLAUDE.md`	团队规范（架构、约定）	提交共享
Local	`./CLAUDE.local.md`	本地配置（密钥、环境）	不提交

权限配置要点

权限模式总览

Claude Code 提供了三种权限模式，覆盖从保守到激进的不同需求：

  ┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
  │   Default Mode    │    │    Auto Mode      │    │  Bypass Mode     │
  │   (默认模式)       │    │   (自动模式)       │    │  (跳过权限)       │
  ├──────────────────┤    ├──────────────────┤    ├──────────────────┤
  │ 每次操作都需确认    │    │ AI 代理审批       │    │ 全部自动通过       │
  │ 安全但效率低       │    │ 分类器审查每步操作  │    │ 高效但风险高       │
  └──────────────────┘    └──────────────────┘    └──────────────────┘
       最安全 ◄──────────────────────────────────────────► 最高效

Auto Mode（推荐）

2026年3月24日 Anthropic 新推出，目前处于 Research Preview 阶段，仅 Team 计划可用，Enterprise 和 API 用户即将开放。

Auto Mode 是介于"手动确认"和"跳过权限"之间的中间路径——让 AI 代理你做权限决策，同时保留安全护栏。

核心机制：每次工具调用执行前，内置分类器审查操作安全性：

  工具调用请求
       │
       ▼
  ┌──────────────┐
  │  分类器审查    │
  └──────┬───────┘
         │
    ┌────┴────┐
    │         │
 安全操作    危险操作
    │         │
 自动放行   阻止 + 重定向
              │
         反复触发？
              │
         上报用户确认

信任模型：

信任：本地工作目录 + Git 仓库配置的远程仓库
不信任：公司源码控制系统、云存储、内部服务（需管理员显式添加为可信资源）

与 Bypass 的核心区别：

维度	Auto Mode	Bypass Permissions
安全性	分类器审查，危险操作被阻止	全部放行，无审查
效率	安全操作自动通过，少中断	全部自动，零中断
适用	日常开发（推荐首选）	CI/CD、隔离环境
可用性	Team 计划（逐步开放中）	所有用户
模型要求	Claude Sonnet 4.6 / Opus 4.6	无限制

启用方式：点击界面中的模式指示器切换到 Auto Mode。

注意事项：

分类器并非完美，可能偶尔误判（放过风险操作或阻止正常操作）
可能略微增加 Token 消耗和延迟
Anthropic 持续优化分类器精度

Bypass Permissions 模式

claude --dangerously-skip-permissions

这个名字带"dangerously"不是吓唬人的。它让你无需等待审批，但用多了才发现，有些坑真的会踩。

Auto Mode 已推出的背景下，Bypass 模式的使用场景已大幅收窄——仅在 CI/CD 等无法使用 Auto Mode 的环境中推荐。

未开启的痛点

痛点 1：批量操作效率低

我：帮我把这 20 个文件都改成 TypeScript

Claude：我要修改 file1.js，确认吗？[Y/n]
我：Y
Claude：我要修改 file2.js，确认吗？[Y/n]
我：Y
...（重复 20 次）

痛点 2：CI/CD 流水线卡住 - 自动化脚本中无法人工确认，导致流水线超时。

痛点 3：快速原型迭代慢 - 探索阶段需要频繁试错，每次确认都会打断思路。

好处与风险

维度	好处	风险
效率	无需等待审批，批量操作流畅	危险操作无法撤回（`rm -rf`）
自动化	CI/CD 流水线中无法人工确认	敏感信息泄露（访问 `.env`）
迭代	原型开发阶段快速试错	审计追踪困难（日志不完整）

安全网设计（多层防护）

建议：不要全开或全关，而是分级授权。

┌─────────────────────────────────────┐
│  Layer 1: allowedTools 白名单        │  只允许必要工具
├─────────────────────────────────────┤
│  Layer 2: deny rules 黑名单          │  禁止危险模式
├─────────────────────────────────────┤
│  Layer 3: Hookify 钩子               │  拦截敏感操作
├─────────────────────────────────────┤
│  Layer 4: Git 版本控制               │  可回滚
├─────────────────────────────────────┤
│  Layer 5: 沙盒环境（可选）             │  容器隔离
└─────────────────────────────────────┘

推荐配置：

// settings.local.json
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Edit(src/**)",
      "Bash(npm run *)",
      "Bash(git *)"
    ],
    "deny": [
      "Bash(rm -rf /*)",
      "Bash(sudo *)",
      "Read(.env)",
      "Edit(.claude/settings.json)"
    ]
  }
}

适用场景判断

场景	推荐模式	原因
日常开发	Auto Mode	安全与效率的最佳平衡
熟悉的代码库重构	Auto Mode / Bypass	风险可控
CI/CD 自动化	Bypass	流水线无法人工确认，Auto Mode 暂不可用
生产环境配置	Default	误操作影响面大
第三方代码库	Default	不了解潜在风险

本文持续更新中，欢迎关注。

参考资料

10011488078 · 2026 年4 月 15 日 12:36

从中能看到不少当初iflow设计和说明文档的影子

10011828298 · 2026 年4 月 20 日 08:17

这是上下文剩余量吗，这个是什么插件实现的啊

10013805030 · 2026 年4 月 21 日 02:03

@10011828298 是的，安装这个插件：GitHub - jarrodwatts/claude-hud: A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress · GitHub

10013805030 · 2026 年4 月 21 日 02:03

这是claude code 官方提供的命令