01简介与核心特性

• 全代码库理解
  自动索引项目结构，理解文件间依赖关系，跨文件追踪上下文
• 终端原生体验
  CLI / VS Code / JetBrains / 桌面应用 / Web 应用，无需切换窗口
• 工具调用
  读写文件、执行 Bash/PowerShell、搜索代码、Git 全流程操作
• MCP 扩展协议
  连接数据库、浏览器、API 等外部系统，能力无限扩展
• 多 Agent 协作
  子 Agent 并行处理，Workflow 编排复杂任务流

02安装与登录

# 安装（需要 Node.js 18+）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 交互式登录（浏览器 OAuth）
claude login

# 使用 API Key 登录
claude login --api-key

# 检查登录状态
claude auth status

03CLI 主命令

# 管道输入
cat error.log | claude -p "分析这个错误日志"

# JSON 输出 + 管道处理
claude -p "列出 src 下所有 TODO" --json | jq '.result'

04常用 Flag

05对话斜杠命令

06快捷键

07CLAUDE.md 项目指令

• 项目记忆和指令系统
  Claude 每次对话自动读取，了解项目上下文、编码规范、工作流约定
• 分层覆盖机制
  ~/.claude/CLAUDE.md（全局）→ ./CLAUDE.md（项目）→ .claude/CLAUDE.local.md（个人）→ 子目录
• 内容建议
  项目概述 · 编码规范 · 构建/测试/lint 命令 · 架构决策的"为什么"

# CLAUDE.md 示例
## 项目概述
基于 Next.js 14 的电商平台，使用 Prisma + PostgreSQL。
## 编码规范
- TypeScript 严格模式，函数式组件 + hooks
- CSS 用 Tailwind，测试用 Vitest
## 命令速查
- 开发：npm run dev ｜ 测试：npm test

08权限系统

• Normal（默认）
  读取类自动执行，写入类操作需确认
• Auto-Accept
  大部分操作自动执行，仅危险操作需确认。按 Shift+Tab 切换
• Plan
  只规划不执行，所有操作需逐一确认

// .claude/settings.json — 粒度化权限规则
{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(git status)",
      "Bash(git diff*)"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(git push --force*)"
    ]
  }
}

09MCP 工具集成

# 添加 MCP 服务器
claude mcp add my-server -- npx -y @anthropic-ai/my-mcp-server

# 带环境变量的服务器
claude mcp add db-server -e DATABASE_URL=postgres://... -- npx -y @mcp/postgres

# 列出 / 删除
claude mcp list
claude mcp remove my-server

10多 Agent 模式

// Workflow 编排示例
export const meta = {
  name: 'code-review',
  phases: [{ title: 'Review' }, { title: 'Verify' }]
}
const results = await pipeline(
  ['bugs', 'perf', 'security'],
  d => agent(`Review for ${d}`, { phase: 'Review' }),
  r => agent(`Verify: ${r}`, { phase: 'Verify' })
)

11自动记忆系统

• 用户记忆（user）
  角色、背景、技术栈偏好——让 Claude 了解你是谁
• 反馈记忆（feedback）
  纠正过的行为和确认有效的做法——同一个错不犯两次
• 项目记忆（project）
  进行中的工作、里程碑、决策动机
• 引用记忆（reference）
  外部系统的指针，如 "bug 追踪在 Linear 的 INGEST 项目"

# 在对话中管理记忆
/memory                                   # 编辑记忆文件
"请记住：这个项目测试用 pytest"             # 手动添加
"忘掉之前关于数据库连接的记忆"              # 手动删除

12Hook 系统

// 自动格式化 Hook 示例
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\""
      }]
    }]
  }
}

13Git 集成

# 提交代码
"提交当前的改动"

# 创建 PR
"创建一个 PR，描述这次重构"

# 审查 PR
"审查 #42 号 PR 的变更"

# 解决冲突
"帮我解决当前的合并冲突"

14Headless 与 CI/CD

# 单次执行
claude -p "分析 src/ 的代码质量"

# JSON 输出
claude -p "列出所有未使用的导入" --json

# 限制最大轮次（防止无限循环）
claude -p "修复所有 lint 错误" --max-turns 10

# GitHub Actions 示例
name: Code Review
on: pull_request
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: |
          npx @anthropic-ai/claude-code \
            -p "审查 PR 的代码变更" --json
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

15SDK 集成

from claude_agent_sdk import Agent

agent = Agent()
result = agent.run(
  "分析项目结构并生成文档"
)
print(result.text)

import { Agent } from
  '@anthropic-ai/claude-agent-sdk'

const agent = new Agent()
const result = await
  agent.run("分析项目结构")

• 自定义工具 — 通过 in-process MCP 服务器注册
• Hook 回调 — 注册 PreToolUse / PostToolUse / Stop
• 流式输出 / 会话管理 — 创建、恢复、继续会话

16最佳实践

17模型选择

• 安全提醒
  不要在 CLAUDE.md 写密钥 · 用 settings.local.json 存个人配置 · 在 deny 中禁止危险命令 · Headless 设 max-turns

18常见问题