🚀 Claude Code 从入门到精通

终端中的超级 AI 编程助手 | Agentic Coding 的标杆产品

"Most software engineers are seriously sleeping on how good LLM agents are right now, especially something like Claude Code."

代码、配置、工作流全部可定制，打造属于你的 AI 编程超级队友

🔧 安装方式

macOS / Linux (推荐)

curl -fsSL https://claude.ai/install.sh | bash

Homebrew

brew install --cask claude-code

旧版 npm (已废弃)

npm install -g @anthropic-ai/claude-code

🖥️ 多环境使用

OrbStack 容器

orb -m ubuntu -u root

mise 环境管理

curl https://mise.run | sh
mise use node
npm install -g @anthropic-ai/claude-code

Windows: 使用 WSL2

📁 CLAUDE.md 项目记忆

位置优先级:

1. .claude/CLAUDE.md
2. ./CLAUDE.md (项目根目录)
3. ~/.claude/CLAUDE.md (全局)

推荐内容:

• 常用 bash 命令
• 代码风格指南
• 测试指令
• 仓库规范
• 环境配置

自动生成: /init 命令

⚙️ settings.json 配置

位置: .claude/settings.json

{
  "model": "claude-sonnet-4",
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "afplay notification.mp3"
      }]
    }]
  },
  "permissions": {
    "allow": ["Bash(ls:*)", "Edit"],
    "deny": ["Bash(rm:*)"]
  }
}

📋 常用斜杠命令

⚡ 快捷键

🧠 思考强度控制

触发 Extended Thinking:

每级分配更多思考预算

🎯 权限模式

YOLO 模式 (危险)

claude --dangerously-skip-permissions

精细化权限

/permissions

规则语法:

• Edit - 允许编辑
• Bash(git commit:*) - 允许 git
• Bash(rm:*) - 禁止删除

🌐 MCP 架构

┌─────────────┐
│ Claude Code │
└──────┬──────┘
       │ MCP Protocol
┌──────▼──────┐
│  MCP Server │ (本地桥接)
└──────┬──────┘
       │ API Call
┌──────▼──────┐
│ External API│
│ JIRA/GitHub │
└─────────────┘

配置文件: .mcp.json

📦 常用 MCP 服务器

Issue Tracking

• @anthropic/mcp-jira
• @anthropic/mcp-linear

Code & DevOps

• @anthropic/mcp-github
• @anthropic/mcp-sentry

Communication

• @anthropic/mcp-slack

Database

• @anthropic/mcp-postgres

Browser

• @playwright/mcp

📝 MCP 配置示例

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-jira"],
      "env": {
        "JIRA_HOST": "${JIRA_HOST}",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

🎓 什么是 Skills

Skills 是教会 Claude 项目特定模式的 Markdown 文档

位置: .claude/skills/{name}/SKILL.md

作用:

• 代码风格规范
• 测试模式
• API 设计规范
• 组件库使用方式
• 调试方法论

核心理念: 让 Claude 生成的代码开箱即用，符合团队规范

📄 SKILL.md 格式

---
name: testing-patterns
description: Jest 测试模式
allowed-tools: Read, Grep, Glob
model: claude-sonnet-4
---

# Testing Patterns

## When to Use
- 编写测试时
- TDD 工作流

## Core Patterns
### AAA 模式
Arrange → Act → Assert

🏷️ Frontmatter 字段

最佳实践:

• 保持 < 500 行
• 包含代码示例
• 写明反模式

🎯 示例 Skills

🔍 Skill 自动评估系统

触发时机: UserPromptSubmit Hook

分析维度:

1. Keywords: 简单词匹配
2. Patterns: 正则匹配
3. File Paths: 文件路径提取
4. Intent: 意图检测

置信度评分:

• keyword: 2分
• pathPattern: 4分
• directoryMatch: 5分
• intentPattern: 4分

🕵️ Agents 专项助手

位置: .claude/agents/{name}.md

格式:

---
name: code-reviewer
description: 代码审查专家
model: opus
---

# Agent System Prompt

你是一位资深代码审查员...

## 审查流程
1. 运行 `git diff`
2. 应用审查清单
3. 提供反馈

📋 示例 Agents

触发: Claude 自动识别或手动调用

⚡ Custom Commands

位置: .claude/commands/{name}.md

调用: /project:{name} 或 /{name}

变量:

• $ARGUMENTS - 全部参数
• $1, $2, $3 - 位置参数

内联 Bash:

当前分支: !`git branch --show-current`

📋 示例 Commands

示例: /ticket PROJ-123

🎣 Hook 事件类型

📤 Hook 响应格式

{
  "block": true,
  "message": "阻止原因",
  "feedback": "非阻塞反馈",
  "suppressOutput": true,
  "continue": false
}

Exit Codes:

• 0 - 成功
• 2 - 阻塞错误 (仅 PreToolUse)
• 其他 - 非阻塞错误

🛡️ 安全 Hook 示例

禁止在 main 分支编辑:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "[ \"$(git branch)\" != \"main\" ]",
        "timeout": 5
      }]
    }]
  }
}

🔔 通知音效 Hook

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "afplay ~/Sounds/done.mp3"
      }]
    }],
    "Notification": [{
      "hooks": [{
        "type": "command",
        "command": "afplay ~/Sounds/notify.mp3"
      }]
    }]
  }
}

✨ 自动格式化 Hook

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

应用场景:

• 代码格式化
• 运行 linter
• 类型检查

🧪 测试触发 Hook

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit",
      "hooks": [{
        "type": "command",
        "command": "if [[ $FILE == *.test.* ]]; then npm test -- $FILE; fi"
      }]
    }]
  }
}

测试文件修改后自动运行测试

🤖 PR 自动审查

name: PR - Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-opus-4-5-20251101
          prompt: "Review this PR..."

📅 定时任务

预估月成本: $10-50 (取决于 PR 数量)

💰 成本估算

节省: 大量人工审查时间

🔄 Explore → Plan → Code → Commit

1. 探索: 阅读相关文件

   • 告诉它"不要写代码"
   • 使用 subagent 深入调查

2. 计划: 让 Claude 制定方案

   • 使用 "think" 触发深度思考
   • 创建计划文档

3. 编码: 实现方案

4. 提交: 生成 PR

🧪 TDD 工作流

1. 写测试: 基于预期输入输出

   • 明确告知是 TDD
   • 避免 mock 实现

2. 验证失败: 确认测试失败

3. 提交测试: 满意后提交

4. 写代码: 让测试通过

   • 不修改测试
   • 迭代直到全部通过

5. 提交代码

🖼️ 视觉迭代工作流

1. 给 Claude 截图能力

   • Puppeteer MCP
   • iOS Simulator MCP

2. 提供设计稿

   • 拖放图片
   • 粘贴截图

3. 实现 → 截图 → 对比 → 迭代

4. 满意后提交

🎫 Ticket 工作流

/ticket PROJ-123

1. 从 JIRA 获取 ticket 详情
2. 读取验收标准
3. 搜索相关代码
4. 创建功能分支
5. 实现功能
6. 更新 JIRA 状态
7. 创建 PR 并链接 ticket

🔀 Multi-Claude 工作流

方式一: 写/审分离

1. Claude A 写代码
2. /clear 或新终端
3. Claude B 审查代码
4. Claude C 根据反馈修改

方式二: Git Worktrees

git worktree add ../feature-a
cd ../feature-a && claude

📊 Headless 自动化

批量处理:

claude -p "migrate foo.py" \
  --allowedTools Edit \
  --output-format json

流水线集成:

claude -p "analyze" --json \
  | your_command

🎮 Vibe Coding

定义: Claude Code + 语音输入 + 纯自然语言

全自动实现功能，很少看代码，只看最终效果

三员大将:

claude --dangerously-skip-permissions
codex --sandbox workspace-write --ask-for-approval never
gemini -m gemini-3-flash-preview --yolo

安全措施: brew install trash && alias rm='trash'

🔌 第三方工具生态

用量监控

• ccusage / claude-code-monitor

状态栏

• CCometixLine (Rust)

音效

• zelda-claude-code

可视化界面

• Claudia

路由器

• claude-code-router

🔗 IDE 集成

VS Code / Cursor:

1. 安装 Claude Code 插件
2. 终端输入 /ide

优势:

• IDE 选中代码 → Claude 感知
• Claude 改动 → IDE 显示 diff
• 双向实时同步

Plan Mode: Shift+Tab 切换

📖 LSP 实时智能

启用:

{
  "enabledPlugins": {
    "typescript-lsp@claude-plugins-official": true,
    "pyright-lsp@claude-plugins-official": true
  }
}

能力:

• 实时错误诊断
• 类型信息
• 代码导航
• 智能补全

📂 项目配置结构

your-project/
├── CLAUDE.md                    # 项目记忆 (可选位置)
├── .mcp.json                    # MCP 服务器配置
├── .claude/
│   ├── settings.json            # Hooks, 环境, 权限
│   ├── settings.local.json      # 个人覆盖 (gitignore)
│   ├── settings.md              # Hook 文档
│   ├── .gitignore
│   ├── agents/                  # 自定义 AI Agents
│   │   └── code-reviewer.md

│   ├── commands/                # 斜杠命令
│   │   ├── onboard.md
│   │   ├── pr-review.md
│   │   └── ticket.md
│   ├── hooks/                   # Hook 脚本
│   │   ├── skill-eval.sh
│   │   ├── skill-eval.js
│   │   └── skill-rules.json
│   └── skills/                  # 领域知识
│       ├── README.md
│       ├── testing-patterns/
│       │   └── SKILL.md
│       └── react-ui-patterns/
│           └── SKILL.md

└── .github/
    └── workflows/
        ├── pr-claude-code-review.yml
        ├── scheduled-claude-code-docs-sync.yml
        ├── scheduled-claude-code-quality.yml
        └── scheduled-claude-code-dependency-audit.yml

版本控制:

• ✅ 提交: settings.json, agents, commands, skills
• ❌ 忽略: settings.local.json, CLAUDE.local.md