Claude Code 进阶使用指南

本文档基于 Claude Code 官方文档（code.claude.com/docs）核实整理，整理日期 2026-07-29。每节末尾附来源链接，可点击查看最新版本。

1. CLI 命令与常用 Flags

1.1 启动方式

1.2 核心 Flags

1.3 实用组合示例

# 无头 + 限定工具 + 限制轮次：一次性修复任务
claude -p "Find and fix type errors in src/" \
  --allowedTools "Bash,Read,Edit" \
  --max-turns 5

# 无头 + JSON 输出 + 成本追踪
claude -p "Analyze this codebase" \
  --output-format json | jq '.total_cost_usd'

# 工作树隔离 + 计划模式：大改动前先出方案
claude --worktree feature-x --permission-mode plan

# 管道处理日志
cat error.log | claude -p "解释这个报错的根因"

2. 交互模式进阶

2.1 常用内置斜杠命令

2.2 键盘与输入技巧

3. 记忆体系（CLAUDE.md）

3.1 层级与加载顺序（优先级从低到高）

3.2 Import 语法

@README.md                      # 相对路径
@~/.claude/shared-rules.md      # 主目录展开

• 最大递归 4 层；代码块和反引号内的 @ 视为字面量

• 项目目录之外的导入首次加载需确认

3.3 自动记忆

• 存储位置：~/.claude/projects/<project>/memory/，MEMORY.md 为索引

• 每次会话只加载索引前 200 行或 25 KB（先到为准），主题文件按需读取

• 用 /memory 管理，或设置 autoMemoryEnabled: false 关闭

4. Skills（自定义斜杠命令）

• 自定义命令已合并进 Skills；.claude/commands/ 仍向后兼容，但推荐用 Skills

• 位置：.claude/skills/<name>/SKILL.md（项目级）或 ~/.claude/skills/（用户级），可带支持脚本和子目录

---
name: deploy
description: 何时触发的说明，Claude 据此自动调用
model: haiku            # 可选，专用模型
tools: ["Read", "Bash"] # 可选，限制工具
invocation: user        # auto 自动触发 / user 仅手动 / never 禁用
---

技能正文：具体指令与流程...

5. Subagents（子代理）

• 位置：.claude/agents/<name>.md 或 ~/.claude/agents/

• Claude 遇到匹配 description 的任务时自动派发；子代理有独立上下文、工具集与权限，完成后只把摘要带回主会话

• 典型场景：探索性搜索（隔离上下文污染）、代码审查、并行实现

---
name: code-reviewer
description: 审查代码改动时使用
model: sonnet
tools: ["Read", "Bash"]
isolation: worktree     # 可选，独立工作树防止文件冲突
---

代理系统提示...

6. Hooks（钩子）

6.1 常用事件

6.2 配置格式（settings.json）

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|Edit|Write",
        "hooks": [
          { "type": "command", "command": "/path/to/check.sh" }
        ]
      }
    ]
  }
}

• matcher 支持精确名（Bash）、多选（Bash|Edit）、正则（mcp__.*__write.*）、全部（*）

• hook 类型：command（本地脚本）与 http（POST 到远程 URL）

• 输入通过 stdin 传 JSON（含 session_id、tool_name、tool_input 等）

6.3 Exit code 语义

7. MCP（Model Context Protocol）

7.1 常用命令

claude mcp add <name> stdio -- node /path/to/server.js   # 本地 stdio
claude mcp add <name> http https://example.com/mcp       # 远程 HTTP
claude mcp add <name> sse https://example.com/sse        # 远程 SSE
claude mcp list                                          # 列出服务器
claude mcp login <name>                                  # OAuth 认证
claude mcp remove <name>                                 # 移除

7.2 作用域

7.3 .mcp.json 示例

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/github-mcp/index.js"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
    },
    "remote-api": { "type": "sse", "url": "https://api.example.com/mcp" }
  }
}

8. 设置与权限（settings.json）

8.1 层级优先级（从低到高）

1. ~/.claude/settings.json（用户全局）

2. .claude/settings.json（项目，git 提交）

3. .claude/settings.local.json（项目本地，gitignored）

4. --settings 参数

5. 托管设置（IT 下发，最高）

8.2 权限规则语法

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

• Bash 规则用前缀匹配（* 通配参数）；文件规则支持 glob（Edit(src/**)）

• deny 优先于 allow；敏感文件（.env、密钥）建议显式 deny

• MCP 工具可整体匹配：mcp__github__*

9. 无头模式与自动化

9.1 Print mode 脚本化

# 结构化输出
claude -p "Extract all function names" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}}}'

# 流式输出（适合接入其他程序）
claude -p "Explain" --output-format stream-json --include-partial-messages

# 批量并行任务
for f in $(cat files.txt); do
  claude -p "迁移 $f" --allowedTools "Edit,Bash" &
done

9.2 Bare mode（CI 推荐）

9.3 GitHub Actions

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Review this PR for security issues"
          claude_args: "--max-turns 5 --model claude-sonnet-5"

10. 其他进阶技巧

10.1 Worktree 并行开发

claude -w feature-auth            # 创建或进入隔离工作树
claude -w feature-auth --tmux     # 配合 tmux

• 多个功能互不干扰，可同时开多个 Claude 会话并行开发

• gitignored 但构建必需的文件（如 .env、嵌入资源）可通过 .worktreeinclude 声明自动复制

• settings.json 中 worktree.baseRef 控制基于远程默认分支（fresh）还是当前 HEAD

10.2 Plan mode

10.3 成本控制

• /cost 查看当前会话花费；--max-budget-usd 给无头任务设硬上限

• 模型选择：简单任务用 Haiku，日常用 Sonnet，复杂推理和审查用 Opus

• 上下文优化：/context 看占用、/compact 主动压缩、不相关任务之间 /clear

10.4 会话管理

claude -n "auth-refactor"         # 命名当前会话
claude --resume "auth-refactor"   # 按名称恢复
claude --resume abc123 --fork-session   # 恢复并分叉，不影响原会话

附：官方文档索引