Claude Code 最新实用技巧指南

By - xu
Posted on 2026年3月12日
Posted in CLI Skills

Claude Code 最新实用技巧指南

最后更新：2026-03-12

Table of Contents

一、多 Agent 功能

Claude Code 支持多 Agent 协作，有两种模式：

1. Subagents（子代理 — 已内置）

子代理是在当前会话中启动的专用 AI 助手，各自拥有独立的上下文窗口。

子代理类型	用途	特点
Explore	快速搜索和分析代码库	只读，速度快（使用 Haiku 模型）
Plan	安全地规划代码修改方案	只读，不会改文件
general-purpose	复杂多步骤任务	拥有所有工具

使用方式：

输入 /agents 查看、创建和管理子代理
Claude 会自动判断何时需要调用子代理
也可以主动要求：用 3 个子代理并行研究认证模块、数据库模块和 API 模块

创建自定义子代理： 在 .claude/agents/ 下创建 .md 文件：

---
name: code-reviewer
description: 代码审查专家，写完代码后自动调用
tools: Read, Grep, Glob
model: sonnet
---

你是一位资深代码审查者。检查代码质量、安全性和最佳实践。
按优先级（严重/警告/建议）报告问题。

2. Agent Teams（代理团队 — 实验性功能）

多个独立的 Claude Code 实例协同工作，通过共享任务列表通信。

启用方式：

// 在 ~/.claude/settings.json 中添加
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

使用示例：

创建一个 4 人代理团队并行重构：
- 一个负责数据库层
- 一个负责 API 层
- 一个负责前端
- 一个负责测试

Subagents vs Agent Teams 对比：

特性	Subagents	Agent Teams
会话	同一会话内运行	多个独立会话
通信	结果汇总回主对话	彼此直接通信
Token 消耗	较低（结果被摘要）	随团队规模线性增长
适用场景	聚焦任务、快速探索	大规模并行协作
推荐团队规模	—	3-5 个 teammates

二、代码审查（Code Review）

1. 自动化 PR 审查（Teams/Enterprise）

管理员在 claude.ai/admin-settings 安装 GitHub App
配置后，PR 创建时自动触发审查
支持通过 REVIEW.md 文件自定义审查规则
审查结果分三级：
- 🔴 Normal — Bug，必须修复
- 🟡 Nit — 建议修复，不阻塞合并
- 🟣 Pre-existing — 历史遗留问题，非本 PR 引入
平均每次审查耗时约 20 分钟，费用 $15-25

2. 本地审查命令

1. 安全审查（内置命令）
/security-review

1. 代码质量审查
/simplify

1. 直接让 Claude 审查
> 审查我最近的代码更改，关注安全性和性能

3. 自定义审查规则（REVIEW.md）

在项目根目录创建 REVIEW.md：

1. Code Review Guidelines

## Always check
- 新 API 端点必须有集成测试
- 数据库迁移必须向后兼容

## Style
- 优先使用早返回，避免深层嵌套

## Skip
- 跳过 `/gen/` 下的生成文件

三、Plan Mode（规划模式）

让 Claude 先分析、规划，不直接修改文件，非常安全。

1. 启动时进入规划模式
claude --permission-mode plan

1. 或在会话中按 Shift+Tab 切换模式

适用场景：

理解不熟悉的代码库
规划复杂的重构方案
在修改前先评估影响范围

四、Hooks 自动化钩子

在特定事件发生时自动执行 shell 命令。

1. 交互式配置
/hooks

可用的 Hook 事件

事件	触发时机
SessionStart	会话开始或恢复
UserPromptSubmit	Claude 处理提示词之前
PreToolUse	工具执行之前（可拦截）
PostToolUse	工具执行成功之后
Notification	Claude 需要你注意时
Stop	Claude 完成回复时

实用配置示例

桌面通知：

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "notify-send 'Claude Code' 'Needs attention'"
      }]
    }]
  }
}

自动格式化（每次编辑后运行 Prettier）：

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

保护敏感文件：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "echo $CLAUDE_FILE_PATH | grep -qE '\\.(env|secret)' && exit 1 || exit 0"
      }]
    }]
  }
}

Hook 类型

Command hooks — 运行 shell 命令
Prompt-based hooks — 通过 Claude 做简单判断
Agent-based hooks — 多轮验证，可访问文件
HTTP hooks — POST 到 URL，适合集中式逻辑

五、MCP 服务器（扩展能力）

MCP（Model Context Protocol）是一个开放标准，让 Claude Code 连接外部工具和 API。

1. 添加 MCP 服务器
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

1. 添加本地 stdio 服务器
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

1. 查看已配置的服务器
claude mcp list

1. 会话内管理
/mcp

安装作用域

作用域	存储位置	用途
Local（默认）	`~/.claude.json`	个人在当前项目使用
Project	`.mcp.json`（项目根目录）	团队共享
User	`~/.claude.json`	所有项目通用

六、常用快捷键

快捷键	功能
Shift+Tab	切换权限模式
Alt+T / Option+T	开关深度思考
Ctrl+S	暂存当前输入
Ctrl+V / Alt+V	粘贴图片
Shift+Enter	多行输入（不发送）
Alt+K / Option+K	插入 @文件引用
Ctrl+O	显示/隐藏详细日志
Ctrl+T	显示/隐藏任务列表
Ctrl+R	搜索命令历史
Ctrl+G	在外部编辑器中打开计划
Ctrl+C	取消当前操作
Ctrl+D	退出 Claude Code
Cmd+P / Meta+P	打开模型选择器

自定义快捷键：

/keybindings
1. 或编辑 ~/.claude/keybindings.json

七、深度思考（Extended Thinking）

1. 开关思考模式
Alt+T

1. 设置思考深度（三个等级）
1. ○ Low / ◐ Medium / ● High

1. 单次深度思考（在提示词中加关键词）
> ultrathink: 分析这个复杂的算法

ultrathink 关键词会让 Claude 在单次回复中投入更多推理资源，适合复杂的架构分析或 debug 场景。

八、Worktree（并行开发）

在隔离的 git worktree 中并行处理不同任务，互不干扰：

1. 在隔离环境中开发新功能
claude --worktree feature-auth

1. 另一个终端修 bug
claude --worktree bugfix-123

1. 如果没有改动，worktree 会自动清理

九、会话管理

1. 继续上次对话
claude --continue

1. 给会话命名
/rename auth-refactor

1. 按名字恢复
claude --resume auth-refactor

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

1. 从 PR 开始会话
claude --from-pr 123

1. Web 会话传送到本地
claude --teleport

十、管道和脚本化

Claude Code 可以作为 Unix 工具使用：

1. 解释错误日志
cat error.log | claude -p '解释这个错误' > output.txt

1. JSON 格式输出
claude -p '分析代码' --output-format json > analysis.json

1. 结构化输出（指定 JSON Schema）
claude -p '列出所有文件' --json-schema '{"type":"object"}' "query"

1. 非交互模式（CI/CD 中使用）
claude -p "运行测试并报告结果" --no-input

十一、CLAUDE.md 配置最佳实践

三个配置层级

项目根目录/CLAUDE.md        → 团队共享规则（提交到 git）
~/.claude/CLAUDE.md         → 个人偏好（所有项目通用）
.claude/rules/*.md          → 路径匹配规则（只在相关文件时加载）

关键原则

保持在 200 行以内，节省上下文空间
指令要具体：写 使用 2 空格缩进 而不是 格式化代码
用 Markdown 结构：用标题和列表分组
支持 @path/to/file 语法引入其他文件
使用 /init 命令可以自动生成 CLAUDE.md

路径匹配规则示例

在 .claude/rules/api-rules.md 中：

---
paths:
  - "src/api/**/*.ts"
---

1. API 开发规则
- 所有端点必须包含输入验证
- 使用标准错误响应格式

十二、IDE 集成

VS Code

安装：扩展商店搜索 “Claude Code”
打开：点击编辑器工具栏的 Spark 图标，或 Cmd+Shift+X
特色功能：原生 diff 对比视图、计划审查、@文件引用、多标签对话

JetBrains

通过 IDE 市场安装
支持终端集成、WSL、远程开发

VS Code 专属快捷键

快捷键	功能
Cmd+Esc / Ctrl+Esc	在编辑器和 Claude 之间切换焦点
Option+K / Alt+K	插入 @文件引用
Cmd+N / Ctrl+N	新建对话
Cmd+Shift+Esc	打开新标签

十三、权限模式

五种模式

模式	说明
`default`	首次使用每个工具时询问权限
`plan`	只读分析，不修改文件
`acceptEdits`	自动接受文件编辑
`dontAsk`	除预批准外自动拒绝
`bypassPermissions`	跳过所有提示（仅限容器环境）

切换方式

1. 启动时指定
claude --permission-mode plan

1. 会话中切换
Shift+Tab

1. 设置默认模式
1. 编辑 .claude/settings.json
{ "defaultMode": "plan" }

权限规则配置

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Read",
      "WebFetch(domain:github.com)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Edit(/secrets/**)"
    ]
  }
}

常用斜杠命令速查

命令	功能
`/agents`	管理子代理
`/hooks`	配置自动化钩子
`/mcp`	管理 MCP 服务器
`/memory`	查看和编辑 CLAUDE.md
`/permissions`	管理权限
`/config`	切换设置
`/keybindings`	配置快捷键
`/init`	生成项目 CLAUDE.md
`/resume`	恢复历史会话
`/rename`	命名当前会话
`/compact`	手动压缩上下文
`/cost`	查看 token 消耗
`/doctor`	检查配置问题
`/vim`	切换 vim 模式
`/simplify`	审查代码质量
`/security-review`	安全审查

xublog

近期文章

近期评论