xublog

近期文章

近期评论

Claude Code 最新实用技巧指南

最后更新：2026-03-12

目录

一、多 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 所有项目通用

热门 MCP 服务器

GitHub、Sentry、Stripe、Notion、Asana、PostgreSQL、Figma、Slack、Playwright 等

六、常用快捷键

快捷键 功能
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 安全审查

参考资源

Previous Article

发表回复

Your email address will not be published. Required fields are marked *.

*
*