2026年Claude Code的最佳实战指南

1. cd /path/to/project
2. claude
3. "给我这个代码库的整体概览"
4. "讲讲这里用的主要架构模式"
5. "认证是怎么处理的？"

"跑 npm test 时报错了：<粘贴完整 stack trace>"
"user.ts 里的 @ts-ignore，给我列几种修法"
"按你建议的方案，给 user.ts 加上空值检查"

"找一下代码库里用到的过期 API"
"给点建议：怎么把 utils.js 重构成用现代 JS 特性"
"用 ES2024 特性重构 utils.js，保持原有行为不变"
"跑一下重构后代码的测试"

"找出 NotificationsService.swift 里没被测试覆盖的函数"
"给 notification service 加测试，覆盖边界场景，不要用 mock"
"跑新加的测试，失败的修掉"

"总结一下我对认证模块做的改动"
"开个 PR"
"PR 描述里再补一些关于安全改进的上下文"

"找出 auth 模块里缺 JSDoc 注释的函数"
"给 auth.js 里没注释的函数补上 JSDoc"
"把生成的文档润色一下，加点上下文和示例"

"这是报错截图，是什么原因？"
"[贴设计稿] 按这个设计实现，完成后截图对比，列出差异并修复"

"解释一下 @src/utils/auth.js 里的逻辑"
"@src/components 的结构是怎样的？"

# 管道分析
cat build-error.txt | claude -p '简明地解释这个构建错误的根本原因' > out.txt
# 结构化输出
cat code.py | claude -p '分析这段代码里的 bug' --output-format json > analysis.json

# 用 auto mode 跑
claude --permission-mode auto -p "fix all lint errors"

"用 subagent 调查我们的认证系统如何处理 token 刷新，有没有现成 OAuth 工具"

claude --worktree feature-auth
claude --worktree bugfix-123

for file in $(cat files.txt); do
  claude -p "把 $file 从 React 迁移到 Vue。返回 OK 或 FAIL。" \
  --allowedTools "Edit,Bash(git commit *)"
done

claude --continue          # 恢复最近的对话
claude --resume            # 从历史会话中选择
claude -n auth-refactor    # 给会话命名
claude --resume auth-refactor # 按名字恢复

# 启动
claude                              # 正常启动
claude --permission-mode plan       # 直接进 Plan Mode
claude --permission-mode auto       # Auto Mode
claude --worktree feature-x         # 隔离 worktree 启动
# 会话内
/init       # 生成 CLAUDE.md 骨架
/clear      # 清空上下文
/compact    # 压缩上下文
/rewind     # 回退到检查点
/btw        # 侧边快速提问（不入上下文）
/rename X   # 重命名当前会话

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude 需要你的关注\" with title \"Claude Code\"'"
      }]
    }]
  }
}