如果你是純小白 ──→ 從頭到尾按順序閱讀，每個(gè)練習(xí)都跟著做
如果你有點(diǎn)基礎(chǔ) ──→ 可以跳過第 3 章，從第 5 章開始
如果你想快速上手 ──→ 直接看第 7 章和第 10 章

┌─────────────────────────────────────────────────────────┐
│                    你（人類）                             │
│   "幫我寫一個(gè)計(jì)算器程序"                                  │
│   "這段代碼為什么報(bào)錯(cuò)？"                                  │
│   "把我的項(xiàng)目打包部署"                                    │
└─────────────────────┬───────────────────────────────────┘
                      │
                      │ 你只需要用中文說話
                      ▼
┌─────────────────────────────────────────────────────────┐
│                 Claude Code（AI 助手）                    │
│                                                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │ 理解你的需求  │  │ 讀取項(xiàng)目文件  │  │ 執(zhí)行命令     │  │
│  │              │  │              │  │              │  │
│  │ "他想做計(jì)算器"│  │ "我來看看    │  │ "mvn compile"│  │
│  │ "需要加減乘除"│  │  現(xiàn)有代碼"   │  │  編譯項(xiàng)目    │  │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘  │
│         │                 │                 │           │
│         └─────────────────┼─────────────────┘           │
│                           │                             │
│                           ▼                             │
│              ┌──────────────────────┐                   │
│              │  生成代碼 / 修復(fù) Bug  │                   │
│              │  運(yùn)行測試 / 部署項(xiàng)目  │                   │
│              └──────────────────────┘                   │
└─────────────────────────────────────────────────────────┘

Claude Code 的能力全景圖
═══════════════════════════════════════════════════════════
  ?? 讀取與搜索               ?? 編寫與修改
  ┌─────────────────┐       ┌─────────────────┐
  │ ? 讀取任何文件    │       │ ? 創(chuàng)建新文件     │
  │ ? 搜索代碼內(nèi)容    │       │ ? 精確修改代碼   │
  │ ? 文件模式匹配    │       │ ? 批量替換內(nèi)容   │
  │ ? 理解項(xiàng)目結(jié)構(gòu)    │       │ ? 重構(gòu)整個(gè)項(xiàng)目   │
  └─────────────────┘       └─────────────────┘
  ? 執(zhí)行與運(yùn)行               ?? 思考與規(guī)劃
  ┌─────────────────┐       ┌─────────────────┐
  │ ? 運(yùn)行終端命令    │       │ ? 分析需求      │
  │ ? 編譯項(xiàng)目       │       │ ? 設(shè)計(jì)方案      │
  │ ? 運(yùn)行測試       │       │ ? 解釋代碼      │
  │ ? 安裝依賴       │       │ ? 教學(xué)指導(dǎo)      │
  │ ? Git 操作       │       │ ? Debug 分析    │
  └─────────────────┘       └─────────────────┘
  ?? 擴(kuò)展能力（高級）         ?? 自動化（高級）
  ┌─────────────────┐       ┌─────────────────┐
  │ ? MCP 工具集成   │       │ ? 定時(shí)任務(wù)      │
  │ ? 自定義技能     │       │ ? 工作流編排    │
  │ ? 多模型切換     │       │ ? 批量處理      │
  │ ? 第三方服務(wù)連接  │       │ ? 自動部署      │
  └─────────────────┘       └─────────────────┘

安裝流程圖
═══════════════════════════════════════════════════════════
  開始
   │
   ▼
┌──────────────────┐
│ 步驟1：安裝 Node.js │  ← 這是 Claude Code 的運(yùn)行環(huán)境
│ (版本 ≥ 18.0)     │    就像手機(jī)需要操作系統(tǒng)一樣
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ 步驟2：安裝       │  ← 在終端里輸入一行命令即可
│ Claude Code      │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ 步驟3：驗(yàn)證安裝   │  ← 確認(rèn)安裝成功
└──────┬───────────┘
       │
       ▼
  完成！開始使用

# 1. 打開瀏覽器，訪問 https://nodejs.org
# 2. 下載 LTS 版本（長期支持版，更穩(wěn)定）
# 3. 雙擊安裝包，一路點(diǎn)擊"下一步"即可
# 4. 安裝完成后，打開終端（Win+R，輸入 cmd，回車）
# 5. 輸入以下命令驗(yàn)證安裝是否成功：
node --version
# 如果安裝成功，你會看到類似這樣的輸出：
# v20.11.0  （版本號可能不同，只要 ≥ 18.0 就沒問題）
npm --version
# 如果安裝成功，你會看到類似這樣的輸出：
# 10.2.4   （npm 是 Node.js 自帶的包管理工具）

# 使用 npm 全局安裝 Claude Code
# -g 表示"全局安裝"，意味著你可以在電腦的任何位置使用它
npm install -g @anthropic-ai/claude-code
# 安裝過程大約需要 1-2 分鐘，你會看到很多行安裝日志在滾動
# 這是正常的，不用擔(dān)心里面的技術(shù)細(xì)節(jié)

# 方法1：使用國內(nèi)鏡像源（推薦，速度更快）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 在終端輸入以下命令：
claude --version
# 如果看到版本號輸出，說明安裝成功！
# 類似：Claude Code v2.0.0

獲取 API Key 的流程
═══════════════════════════════════════════════════════════
  訪問 console.anthropic.com
   │
   ▼
  注冊 / 登錄賬號
   │
   ▼
  進(jìn)入 API Keys 頁面
   │
   ▼
  點(diǎn)擊 "Create Key" 創(chuàng)建新 Key
   │
   ▼
  ?? 復(fù)制并保存好 Key?。ㄖ伙@示一次）
   │
   ▼
  在終端配置 Key

# 在 Git Bash 終端中輸入（Windows用戶推薦這種方式）
# 把下面的 "sk-ant-xxxxx" 替換成你自己的真實(shí)的 API Key
export ANTHROPIC_API_KEY="sk-ant-your-actual-api-key-here"
# 注意：這種方式只在當(dāng)前終端窗口有效，關(guān)閉窗口后需要重新設(shè)置
# 如果你想讓這個(gè)配置永久生效，繼續(xù)往下看

# Windows PowerShell 用戶
# 以管理員身份打開 PowerShell，執(zhí)行：
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-your-key-here", "User")
# Git Bash / Mac / Linux 用戶
# 把下面這行加到你的 ~/.bashrc 或 ~/.zshrc 文件末尾
echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.bashrc
# 讓配置立即生效
source ~/.bashrc

# 如果你已經(jīng)有 Anthropic 賬號，可以直接用這個(gè)命令登錄
claude login
# 這會打開瀏覽器，讓你通過網(wǎng)頁完成認(rèn)證
# 認(rèn)證成功后，Claude Code 會自動保存你的憑證

# 在終端輸入：
claude
# 如果一切配置正確，你會進(jìn)入 Claude Code 的交互界面
# 你會看到一個(gè)類似這樣的提示符，表示可以開始對話了：
#
# ╭────────────────────────────────────────────╮
# │  ? Claude Code v2.0.0                      │
# │  Ready to help you build amazing things!    │
# ╰────────────────────────────────────────────╯
# >

# 進(jìn)入你的項(xiàng)目目錄（如果還沒有項(xiàng)目，先創(chuàng)建一個(gè)空目錄）
mkdir my-first-project      # 創(chuàng)建一個(gè)名為 my-first-project 的文件夾
cd my-first-project          # 進(jìn)入這個(gè)文件夾
# 啟動 Claude Code
claude

# 不進(jìn)入交互界面，直接執(zhí)行一條指令
# -p 參數(shù)表示 "print"，意思是直接打印結(jié)果
claude -p "寫一個(gè) Hello World 的 Python 程序"

> 你好！請用中文回復(fù)我。請解釋一下你是什么，你能幫我做什么？

┌─────────────────────────────────────────────────────────┐
│                    交互模式的工作流程                      │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   你輸入問題                                             │
│   ┌──────────────────────┐                              │
│   │ > 幫我寫一個(gè)計(jì)算器     │                              │
│   └──────────┬───────────┘                              │
│              │                                           │
│              ▼                                           │
│   ┌──────────────────────┐                              │
│   │ Claude Code 分析你的  │  ← AI 理解你的意圖             │
│   │ 需求，讀取項(xiàng)目文件    │                              │
│   └──────────┬───────────┘                              │
│              │                                           │
│              ▼                                           │
│   ┌──────────────────────┐                              │
│   │ Claude Code 生成代碼  │  ← AI 創(chuàng)建或修改文件           │
│   │ 或執(zhí)行相關(guān)操作        │                              │
│   └──────────┬───────────┘                              │
│              │                                           │
│              ▼                                           │
│   ┌──────────────────────┐                              │
│   │ Claude Code 展示結(jié)果  │  ← AI 告訴你做了什么           │
│   │ 等待你的下一步指令    │                              │
│   └──────────────────────┘                              │
│              │                                           │
│              ▼                                           │
│         繼續(xù)對話……                                       │
│                                                         │
└─────────────────────────────────────────────────────────┘

> 幫我用 Python 寫一個(gè)計(jì)算器程序，要求支持加減乘除四種運(yùn)算。
   用戶輸入兩個(gè)數(shù)字和運(yùn)算符，程序輸出計(jì)算結(jié)果。
   代碼要包含詳細(xì)的中文注釋。
> 這段代碼運(yùn)行時(shí)報(bào)錯(cuò)了，錯(cuò)誤信息是：
   "NameError: name 'result' is not defined"
   幫我分析一下原因并修復(fù)。
> 我的項(xiàng)目里有 5 個(gè) Java 文件，幫我找一下哪個(gè)文件里定義了 UserService 類。

> 寫代碼
   ← 太模糊了，AI 不知道你想要什么
> 修復(fù)錯(cuò)誤
   ← 沒說是什么錯(cuò)誤，AI 無法定位問題
> 幫我做個(gè)東西
   ← 沒有具體描述，AI 會困惑

# ─── 基礎(chǔ)命令 ───
/help              # 顯示幫助信息，列出所有可用命令
# 用法：直接輸入 /help 即可
# 作用：查看 Claude Code 支持的所有功能和快捷命令
/clear             # 清空當(dāng)前對話歷史，開始新的話題
# 用法：當(dāng)你想切換話題或之前的對話太長時(shí)使用
# 注意：這不會刪除任何文件，只是清空對話記錄
/compact           # 壓縮對話歷史，釋放上下文空間
# 用法：當(dāng)對話很長，AI 響應(yīng)變慢時(shí)使用
# 作用：保留關(guān)鍵信息，刪除冗余內(nèi)容，讓 AI 重新"聚焦"
# ─── 會話管理 ───
/status            # 查看當(dāng)前會話狀態(tài)
# 顯示：當(dāng)前模型、對話長度、文件變更等信息
/context           # 查看當(dāng)前上下文包含的內(nèi)容
# 顯示：AI 當(dāng)前"看到"了哪些信息
# ─── 文件與項(xiàng)目 ───
/init              # 初始化項(xiàng)目，創(chuàng)建 CLAUDE.md 項(xiàng)目說明文件
# 用法：在項(xiàng)目根目錄執(zhí)行 /init
# 作用：讓 Claude Code 更好地理解你的項(xiàng)目結(jié)構(gòu)和規(guī)則
/add-dir           # 添加一個(gè)目錄到工作區(qū)
# 用法：/add-dir src/   （將 src 目錄加入關(guān)注范圍）
# ─── 配置與管理 ───
/config            # 查看和修改 Claude Code 的設(shè)置
# 用法：/config 進(jìn)入設(shè)置頁面
/model             # 切換使用的 AI 模型
# 用法：/model opus    （切換到 Opus 模型，能力最強(qiáng)）
#       /model sonnet  （切換到 Sonnet 模型，速度更快）
# ─── 費(fèi)用與用量 ───
/cost              # 查看當(dāng)前會話的費(fèi)用消耗
# 用法：/cost    顯示本次對話花了多少錢
/usage             # 查看 Token 使用量
# Token 是 AI 處理文本的計(jì)量單位，類似電話的"分鐘"

上下文窗口示意圖
═══════════════════════════════════════════════════════════
  ┌─────────────────────────────────────────────────────┐
  │              上下文窗口（Context Window）             │
  │              Claude Opus 最大支持 100 萬 Token        │
  │                                                     │
  │  ┌──────────────────────┐                           │
  │  │  系統(tǒng)提示詞           │  ← 定義 AI 的角色和行為     │
  │  │  (System Prompt)     │     如"你是一個(gè)編程助手"   │
  │  ├──────────────────────┤                           │
  │  │                      │                           │
  │  │  對話歷史             │  ← 你和 AI 你來我往的記錄   │
  │  │  (Conversation)      │     每一輪對話都在這里     │
  │  │                      │                           │
  │  │  ? 你：幫我寫代碼     │                           │
  │  │  ? AI：好的，這是代碼  │                           │
  │  │  ? 你：有個(gè)錯(cuò)誤……    │                           │
  │  │  ? AI：我來修復(fù)……    │                           │
  │  ├──────────────────────┤                           │
  │  │  當(dāng)前請求             │  ← 你最新輸入的問題         │
  │  │  (Current Request)   │                           │
  │  └──────────────────────┘                           │
  └─────────────────────────────────────────────────────┘
  當(dāng)上下文滿了 → AI 可能會"忘記"早期的對話內(nèi)容
  解決方法 → /compact 命令壓縮對話 或 /clear 清空重新開始

# 查看當(dāng)前使用了多少上下文
/context
# 如果對話太長，壓縮上下文（保留關(guān)鍵信息，刪除冗余）
/compact
# 完全開始新話題
/clear

Token 的直觀理解
═══════════════════════════════════════════════════════════

  中文："你好世界"           ≈ 4 個(gè) Token
  英文："Hello World"        ≈ 2 個(gè) Token
  一句普通的中文問句          ≈ 20-50 個(gè) Token
  一個(gè) 100 行的 Python 文件   ≈ 800-1500 個(gè) Token
  一個(gè)中等規(guī)模的項(xiàng)目（100個(gè)文件） ≈ 50萬-200萬 Token

  費(fèi)用參考（以 Claude Opus 為例）：
  ┌─────────────────────────────────────────────┐
  │  輸入（你發(fā)給 AI 的內(nèi)容）：$5 / 100萬 Token    │
  │  輸出（AI 回復(fù)的內(nèi)容）：  $25 / 100萬 Token   │
  │                                             │
  │  換句話說：                                  │
  │  ? 問一個(gè)問題 ≈ 幾分錢                        │
  │  ? 寫一個(gè)完整功能 ≈ 幾毛錢                     │
  │  ? 完成一個(gè)項(xiàng)目 ≈ 幾塊錢到幾十塊錢              │
  └─────────────────────────────────────────────┘

# 在 Claude Code 中隨時(shí)查看當(dāng)前會話的費(fèi)用
/cost
# 輸出示例：
# Total cost:     $0.42
# Input tokens:   45,230
# Output tokens:  2,156

Claude Code 的內(nèi)置工具一覽
═══════════════════════════════════════════════════════════
  ┌─────────────────────────────────────────────────────────┐
  │                      工具清單                            │
  ├───────────────┬─────────────────────────────────────────┤
  │ 工具名稱       │ 作用（用人話解釋）                        │
  ├───────────────┼─────────────────────────────────────────┤
  │ Read          │ "讀文件"——就像你打開文件查看內(nèi)容           │
  │               │ 可以讀代碼、讀文檔、讀圖片、讀 PDF         │
  ├───────────────┼─────────────────────────────────────────┤
  │ Write         │ "寫文件"——創(chuàng)建新文件或覆蓋已有文件         │
  │               │ 就像你在編輯器里新建文件并寫入內(nèi)容          │
  ├───────────────┼─────────────────────────────────────────┤
  │ Edit          │ "改文件"——精確修改文件中的某段內(nèi)容         │
  │               │ 不是整個(gè)重寫，而是精準(zhǔn)替換                 │
  ├───────────────┼─────────────────────────────────────────┤
  │ Bash          │ "執(zhí)行命令"——在終端里運(yùn)行指令               │
  │               │ 可以編譯代碼、安裝依賴、運(yùn)行測試            │
  ├───────────────┼─────────────────────────────────────────┤
  │ Glob          │ "找文件"——按文件名模式搜索                 │
  │               │ 比如找所有 .java 文件或所有 test*.js      │
  ├───────────────┼─────────────────────────────────────────┤
  │ Grep          │ "搜內(nèi)容"——在文件內(nèi)容中搜索關(guān)鍵詞           │
  │               │ 比如找所有包含"password"的代碼行          │
  ├───────────────┼─────────────────────────────────────────┤
  │ WebFetch      │ "抓網(wǎng)頁"——獲取網(wǎng)頁內(nèi)容                    │
  │               │ 可以讀取在線文檔、API 說明等               │
  ├───────────────┼─────────────────────────────────────────┤
  │ WebSearch     │ "搜網(wǎng)頁"——搜索互聯(lián)網(wǎng)                      │
  │               │ 查找最新信息、技術(shù)方案等                   │
  ├───────────────┼─────────────────────────────────────────┤
  │ Task          │ "多任務(wù)"——同時(shí)處理多個(gè)獨(dú)立工作             │
  │               │ 比如同時(shí)搜索多個(gè)目錄或處理多個(gè)文件          │
  └───────────────┴─────────────────────────────────────────┘

    你說："幫我把項(xiàng)目里所有的 TODO 注釋找出來"
                         │
                         ▼
    Claude Code 內(nèi)部自動執(zhí)行：
    ┌──────────────────────────────────────┐
    │ 1. 分析需求："找 TODO 注釋"          │
    │ 2. 選擇工具：用 Grep 工具搜索        │
    │ 3. 執(zhí)行：grep "TODO" 遍歷所有文件     │
    │ 4. 整理結(jié)果：把找到的 TODO 列給你看   │
    │ 5. 回復(fù)："找到了 12 個(gè) TODO……"       │
    └──────────────────────────────────────┘

權(quán)限級別說明
═══════════════════════════════════════════════════════════
  ┌─────────────────────────────────────────────────────────┐
  │  操作類型            │  是否需要你確認(rèn)  │  示例           │
  ├──────────────────────┼─────────────────┼────────────────┤
  │  讀文件              │  不需要（自動）  │  "看看這個(gè)文件"  │
  │  搜索內(nèi)容            │  不需要（自動）  │  "搜一下 TODO"  │
  │  寫新文件            │  需要確認(rèn)        │  "創(chuàng)建一個(gè)文件"  │
  │  修改已有文件         │  需要確認(rèn)        │  "修改這行代碼"  │
  │  執(zhí)行命令            │  需要確認(rèn)        │  "運(yùn)行 npm test"│
  │  訪問外部網(wǎng)站         │  需要確認(rèn)        │  "查看這個(gè)網(wǎng)頁"  │
  │  刪除文件            │  需要確認(rèn)        │  "刪除這個(gè)文件"  │
  └──────────────────────┴─────────────────┴────────────────┘
  你可以選擇：
  ? 允許（Allow）          —— 僅這次
  ? 總是允許（Always Allow）—— 同類型操作不再詢問
  ? 拒絕（Deny）            —— 不允許執(zhí)行

場景：你剛接手一個(gè)項(xiàng)目，想了解某個(gè)文件做了什么
你：幫我看看 src/main/java/com/example/UserController.java 這個(gè)文件，
   解釋一下每個(gè)方法是做什么的，用中文說明。
Claude Code 會：
1. 自動使用 Read 工具讀取文件
2. 分析代碼結(jié)構(gòu)
3. 用通俗的中文解釋每個(gè)方法的作用
4. 可能還會指出潛在的問題或改進(jìn)建議

場景：產(chǎn)品經(jīng)理給了你一張 UI 設(shè)計(jì)圖，讓你實(shí)現(xiàn)
你：看看這張?jiān)O(shè)計(jì)圖 design.png，告訴我這是一個(gè)什么樣的頁面布局。
Claude Code 會：
1. 讀取圖片文件
2. 分析圖片中的 UI 元素
3. 描述布局結(jié)構(gòu)
4. 甚至可以幫你生成對應(yīng)的 HTML/CSS 代碼

場景：你想找到所有調(diào)用了 getUserById 方法的地方
你：幫我在整個(gè)項(xiàng)目中搜索所有調(diào)用 getUserById 的地方，
   列出文件名和行號。
Claude Code 會：
1. 自動使用 Grep 工具搜索
2. 返回所有匹配的行及其位置
3. 你可以點(diǎn)擊行號直接跳轉(zhuǎn)

場景：你記得有個(gè)文件名叫 UserService 但忘了在哪個(gè)目錄
你：幫我找到所有文件名包含 UserService 的 Java 文件。
Claude Code 會：
1. 使用 Glob 工具按文件名模式匹配
2. 列出所有匹配的文件路徑

場景：你想給 UserService 類添加一個(gè)新方法
你：在 src/main/java/com/example/UserService.java 中
   添加一個(gè) findByEmail 方法，參數(shù)是 String email，
   返回 Optional<User>。
Claude Code 會：
1. 讀取 UserService.java 的內(nèi)容
2. 分析類的結(jié)構(gòu)
3. 在合適的位置插入新方法
4. 確保代碼格式和項(xiàng)目風(fēng)格一致
5. 展示修改后的結(jié)果讓你確認(rèn)

// ========== 修改前 ==========
public class UserService {
    public Optional<User> findById(Long id) {
        // 根據(jù) ID 查找用戶
        return userRepository.findById(id);
    }
}
// ========== 修改后 ==========
public class UserService {
    public Optional<User> findById(Long id) {
        // 根據(jù) ID 查找用戶
        return userRepository.findById(id);
    }
    // 【新增方法】根據(jù)郵箱地址查找用戶
    // @param email 用戶的郵箱地址
    // @return 包含用戶的 Optional 對象，如果找不到則為空
    public Optional<User> findByEmail(String email) {
        // 調(diào)用 Repository 層的 findByEmail 方法查詢數(shù)據(jù)庫
        return userRepository.findByEmail(email);
    }
}

# 場景：你想編譯一個(gè) Java 項(xiàng)目
# 傳統(tǒng)方式（你需要記住命令）：
mvn clean compile -DskipTests
# Claude Code 方式（說人話就行）：
> 幫我編譯這個(gè) Java 項(xiàng)目，跳過測試。
# Claude Code 會自動執(zhí)行：
# mvn clean compile -DskipTests
# 然后把編譯結(jié)果翻譯成你能看懂的中文告訴你

你說："幫我看看這個(gè) Spring Boot 項(xiàng)目能不能正常啟動"
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│  Claude Code 內(nèi)部處理流程                                │
│                                                         │
│  1. 分析項(xiàng)目類型                                         │
│     → 發(fā)現(xiàn) pom.xml → 判定為 Maven 管理的 Spring Boot 項(xiàng)目 │
│                                                         │
│  2. 確定啟動命令                                         │
│     → mvn spring-boot:run                               │
│                                                         │
│  3. 請求你的確認(rèn)                                         │
│     → "我將執(zhí)行 mvn spring-boot:run，是否允許？"          │
│                                                         │
│  4. 執(zhí)行命令并捕獲輸出                                    │
│     → 啟動日志會顯示在終端                               │
│                                                         │
│  5. 分析結(jié)果                                             │
│     → 如果啟動成功：告訴你端口號和訪問地址                 │
│     → 如果啟動失?。簬湍惴治鲥e(cuò)誤原因并修復(fù)                 │
└─────────────────────────────────────────────────────────┘

# 1. 創(chuàng)建項(xiàng)目文件夾
mkdir my-homepage
cd my-homepage
# 2. 啟動 Claude Code
claude

> 幫我創(chuàng)建一個(gè)個(gè)人主頁，要求：
  1. 只用一個(gè) index.html 文件（把 CSS 和 JS 都寫在里面）
  2. 設(shè)計(jì)要簡潔大方，使用現(xiàn)代的設(shè)計(jì)風(fēng)格
  3. 包含以下內(nèi)容：
     - 頂部導(dǎo)航欄：首頁、關(guān)于我、技能、聯(lián)系方式
     - 主頁橫幅區(qū)：我的名字（張三）、一句話介紹
     - 關(guān)于我區(qū)域：一段個(gè)人簡介
     - 技能展示區(qū)：用卡片展示我會的技能
     - 聯(lián)系方式區(qū)：郵箱、GitHub、微信
     - 底部版權(quán)信息
  4. 顏色方案用藍(lán)色系
  5. 代碼中加上詳細(xì)的中文注釋，我是初學(xué)者

# Claude Code 寫完后，幫我在瀏覽器里打開看看
> 幫我在瀏覽器里打開這個(gè) index.html 文件

> 我覺得背景色太深了，幫我改成淺藍(lán)色
> 導(dǎo)航欄的字體再大一些
> 把技能卡片改成 3 列布局，現(xiàn)在太寬了

<!DOCTYPE html>
<!-- 這行告訴瀏覽器：這是一個(gè) HTML5 文檔 -->
<html lang="zh-CN">
<!-- lang="zh-CN" 表示頁面主要語言是簡體中文 -->
<head>
    <!-- head 標(biāo)簽包含頁面的"元信息"——用戶看不到，但瀏覽器需要 -->
    <meta charset="UTF-8">
    <!-- 設(shè)置字符編碼為 UTF-8，這樣中文才能正常顯示 -->
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <!-- 讓頁面在手機(jī)上也能正常顯示（響應(yīng)式設(shè)計(jì)的基礎(chǔ)） -->
    <title>張三 - 個(gè)人主頁</title>
    <!-- 瀏覽器標(biāo)簽頁上顯示的標(biāo)題 -->
    <style>
        /* ========== 全局樣式 ========== */
        /* * 是通配符，選中所有元素 */
        * {
            margin: 0;
            /* 清除默認(rèn)的外邊距 */
            padding: 0;
            /* 清除默認(rèn)的內(nèi)邊距 */
            box-sizing: border-box;
            /* 讓寬高計(jì)算方式更直觀 */
        }
        /* body 是頁面主體，所有可見內(nèi)容都在里面 */
        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            /* 設(shè)置字體，從前往后依次嘗試 */
            line-height: 1.6;
            /* 行高 1.6 倍，讓文字不擁擠 */
            color: #333;
            /* 文字顏色：深灰色（比純黑柔和） */
            background-color: #f0f4f8;
            /* 背景色：淺藍(lán)灰色 */
        }
        /* ========== 導(dǎo)航欄樣式 ========== */
        /* nav 是 HTML5 的語義化標(biāo)簽，表示導(dǎo)航區(qū)域 */
        nav {
            background-color: #1a56db;
            /* 導(dǎo)航欄背景：深藍(lán)色 */
            padding: 16px 0;
            /* 上下內(nèi)邊距 16px，左右 0 */
            position: sticky;
            /* 粘性定位：滾動時(shí)導(dǎo)航欄固定在頂部 */
            top: 0;
            /* 距離頂部 0px */
            z-index: 100;
            /* 層級最高，確保不被其他元素遮擋 */
        }
        /* 導(dǎo)航欄內(nèi)部的容器，用于控制內(nèi)容寬度 */
        nav .container {
            max-width: 1000px;
            /* 最大寬度 1000px */
            margin: 0 auto;
            /* 上下 0，左右自動（居中） */
            display: flex;
            /* 使用彈性布局 */
            justify-content: space-between;
            /* 子元素兩端對齊 */
            align-items: center;
            /* 子元素垂直居中 */
        }
        /* 網(wǎng)站 Logo/標(biāo)題 */
        nav .logo {
            color: white;
            /* 文字白色 */
            font-size: 22px;
            /* 字體大小 */
            font-weight: bold;
            /* 加粗 */
        }
        /* 導(dǎo)航鏈接列表 */
        nav ul {
            list-style: none;
            /* 去掉列表的小圓點(diǎn) */
            display: flex;
            /* 讓列表項(xiàng)橫向排列 */
            gap: 24px;
            /* 每項(xiàng)之間的間距 */
        }
        /* 導(dǎo)航鏈接樣式 */
        nav ul li a {
            color: rgba(255, 255, 255, 0.85);
            /* 半透明白色 */
            text-decoration: none;
            /* 去掉下劃線 */
            font-size: 15px;
            transition: color 0.3s;
            /* 顏色變化有 0.3 秒過渡動畫 */
        }
        /* 鼠標(biāo)懸停在導(dǎo)航鏈接上時(shí)的效果 */
        nav ul li a:hover {
            color: white;
            /* 變?yōu)榧儼咨?*/
        }
        /* ========== 橫幅區(qū)樣式 ========== */
        .hero {
            background: linear-gradient(135deg, #1a56db 0%, #4f8cf7 100%);
            /* 漸變背景：從深藍(lán)到淺藍(lán)，135度角 */
            color: white;
            padding: 80px 0;
            /* 上下 80px 的內(nèi)邊距，讓橫幅更高 */
            text-align: center;
            /* 文字居中 */
        }
        .hero h1 {
            font-size: 40px;
            /* 主標(biāo)題大號字體 */
            margin-bottom: 12px;
        }
        .hero p {
            font-size: 18px;
            opacity: 0.9;
            /* 略微透明 */
        }
        /* ========== 通用容器和區(qū)塊樣式 ========== */
        .container {
            max-width: 1000px;
            margin: 0 auto;
            padding: 0 20px;
            /* 左右保留 20px 安全距離 */
        }
        section {
            padding: 60px 0;
            /* 每個(gè)區(qū)塊上下 60px 間距 */
        }
        section h2 {
            text-align: center;
            font-size: 28px;
            margin-bottom: 36px;
            color: #1a56db;
        }
        /* ========== 關(guān)于我區(qū)域 ========== */
        .about p {
            font-size: 16px;
            text-align: center;
            max-width: 680px;
            margin: 0 auto;
            /* 段落居中，最大寬度 680px，閱讀更舒適 */
        }
        /* ========== 技能卡片區(qū)域 ========== */
        .skills-grid {
            display: grid;
            /* 使用網(wǎng)格布局 */
            grid-template-columns: repeat(3, 1fr);
            /* 3 列，每列等寬 */
            gap: 20px;
            /* 卡片之間的間距 */
        }
        /* 單個(gè)技能卡片 */
        .skill-card {
            background: white;
            /* 白色背景 */
            padding: 28px;
            border-radius: 10px;
            /* 圓角 */
            text-align: center;
            box-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);
            /* 投影陰影：水平0 垂直2px 模糊10px 黑色8%透明度 */
            transition: transform 0.3s;
            /* 懸停動畫 */
        }
        .skill-card:hover {
            transform: translateY(-4px);
            /* 鼠標(biāo)懸停時(shí)向上移動 4px，有"浮起來"的感覺 */
        }
        .skill-card .icon {
            font-size: 36px;
            /* 圖標(biāo)（emoji）的尺寸 */
            margin-bottom: 12px;
        }
        .skill-card h3 {
            margin-bottom: 8px;
            color: #1a56db;
        }
        /* ========== 聯(lián)系方式區(qū)域 ========== */
        .contact-info {
            text-align: center;
            font-size: 16px;
        }
        .contact-info p {
            margin-bottom: 8px;
        }
        /* ========== 頁腳樣式 ========== */
        footer {
            background-color: #1a2938;
            /* 深色背景 */
            color: #9ca3af;
            /* 灰色文字 */
            text-align: center;
            padding: 20px 0;
            font-size: 14px;
        }
    </style>
</head>
<body>
    <!-- ========== 導(dǎo)航欄 ========== -->
    <nav>
        <div class="container">
            <!-- 左側(cè) Logo -->
            <span class="logo">張三</span>
            <!-- 右側(cè)導(dǎo)航鏈接 -->
            <ul>
                <!-- href="#" 表示點(diǎn)擊后跳轉(zhuǎn)到當(dāng)前頁面的指定位置 -->
                <li><a href="#home">首頁</a></li>
                <li><a href="#about">關(guān)于我</a></li>
                <li><a href="#skills">技能</a></li>
                <li><a href="#contact">聯(lián)系方式</a></li>
            </ul>
        </div>
    </nav>
    <!-- ========== 主頁橫幅 ========== -->
    <section class="hero" id="home">
        <h1>張三</h1>
        <p>熱愛技術(shù)的全棧開發(fā)者 | 終身學(xué)習(xí)者 | 開源愛好者</p>
    </section>
    <!-- ========== 關(guān)于我 ========== -->
    <section class="about" id="about">
        <div class="container">
            <h2>關(guān)于我</h2>
            <p>
                你好！我是張三，一名擁有 3 年經(jīng)驗(yàn)的全棧開發(fā)者。
                我熱愛用代碼創(chuàng)造有價(jià)值的軟件產(chǎn)品，喜歡學(xué)習(xí)新技術(shù)。
                工作之余，我活躍在 GitHub 開源社區(qū)，參與過多個(gè)知名項(xiàng)目的貢獻(xiàn)。
                我相信技術(shù)的力量可以讓世界變得更好。
            </p>
        </div>
    </section>
    <!-- ========== 技能展示 ========== -->
    <section id="skills">
        <div class="container">
            <h2>我的技能</h2>
            <div class="skills-grid">
                <!-- 技能卡片 1 -->
                <div class="skill-card">
                    <div class="icon">?</div>
                    <h3>Java</h3>
                    <p>精通 Java 后端開發(fā)，Spring Boot 框架</p>
                </div>
                <!-- 技能卡片 2 -->
                <div class="skill-card">
                    <div class="icon">??</div>
                    <h3>Python</h3>
                    <p>熟練使用 Python 進(jìn)行數(shù)據(jù)處理和 Web 開發(fā)</p>
                </div>
                <!-- 技能卡片 3 -->
                <div class="skill-card">
                    <div class="icon">??</div>
                    <h3>前端開發(fā)</h3>
                    <p>掌握 HTML、CSS、JavaScript 和 Vue.js</p>
                </div>
            </div>
        </div>
    </section>
    <!-- ========== 聯(lián)系方式 ========== -->
    <section id="contact">
        <div class="container">
            <h2>聯(lián)系我</h2>
            <div class="contact-info">
                <p>?? 郵箱：zhangsan@example.com</p>
                <p>?? GitHub：github.com/zhangsan</p>
                <p>?? 微信：zhangsan_dev</p>
            </div>
        </div>
    </section>
    <!-- ========== 頁腳 ========== -->
    <footer>
        <div class="container">
            <p>&copy; 2026 張三 | 保留所有權(quán)利</p>
            <!-- &copy; 是版權(quán)符號 ? -->
        </div>
    </footer>
</body>
</html>

# 在項(xiàng)目根目錄下執(zhí)行
claude
> /init

# OCP 電商平臺項(xiàng)目
## 項(xiàng)目簡介
這是一個(gè)基于 Spring Boot 的在線商城系統(tǒng)，提供商品瀏覽、購物車、下單等功能。
## 技術(shù)棧
- 后端框架：Spring Boot 2.7.x
- 構(gòu)建工具：Maven
- 數(shù)據(jù)庫：MySQL 8.0 + MyBatis-Plus
- 緩存：Redis
- Java 版本：JDK 11
## 項(xiàng)目結(jié)構(gòu)

## 編碼規(guī)范
- 類名使用大駝峰命名法，如 UserController
- 方法名和變量名使用小駝峰命名法，如 findUserById
- 所有 public 方法必須有 Javadoc 注釋
- Controller 層只做參數(shù)校驗(yàn)和轉(zhuǎn)發(fā)，不寫業(yè)務(wù)邏輯
- 使用 Lombok 簡化 getter/setter
## 運(yùn)行方式
?```bash
# 編譯
mvn clean compile
# 運(yùn)行測試
mvn test
# 啟動項(xiàng)目
mvn spring-boot:run
# 啟動后訪問 http://localhost:8080

### 8.2 項(xiàng)目中 Claude Code 的日常工作流
有了 CLAUDE.md 后，Claude Code 就"認(rèn)識"你的項(xiàng)目了。下面是日常工作中最常用的幾種交互模式：

### 8.3 實(shí)際工作場景演示
讓我們模擬幾個(gè)真實(shí)的開發(fā)場景：
**場景一：添加新功能**

  1. 在 UserController 中添加 POST /api/users/register 接口
  2. 在 UserService 中添加 register 方法
  3. 注冊時(shí)校驗(yàn)郵箱格式和密碼長度（至少6位）
  4. 密碼需要用 BCrypt 加密后存儲
  5. 返回格式統(tǒng)一使用 Result 類包裝

**場景二：修復(fù) Bug**

**場景三：代碼重構(gòu)**

### 8.4 Git 版本管理
Claude Code 可以幫助你管理代碼版本（使用 Git），即使你完全不懂 Git 命令：

---
## 9. 高級功能：讓 Claude Code 更強(qiáng)大
當(dāng)你掌握了基礎(chǔ)功能后，這些高級功能可以幫助你進(jìn)一步提升效率。
### 9.1 MCP（模型上下文協(xié)議）—— 連接外部世界
**概念解釋：**
MCP 的全稱是 Model Context Protocol（模型上下文協(xié)議）。用人話來說——**它是讓 Claude Code 能連接各種外部工具和服務(wù)的"萬能插頭"**。
> **比喻**：你的手機(jī)只有一個(gè)充電口，但是通過不同的轉(zhuǎn)接頭，你可以連 U 盤、顯示器、鍵盤…… MCP 就是 AI 世界的那個(gè)"萬能轉(zhuǎn)接頭"。

**MCP 的常見應(yīng)用：**
| MCP 服務(wù) | 能讓 Claude Code 做什么 |
|---------|------------------------|
| GitHub MCP | 創(chuàng)建 Issue、提交 PR、查看代碼變更 |
| 數(shù)據(jù)庫 MCP | 直接查詢數(shù)據(jù)庫、執(zhí)行 SQL |
| Jira MCP | 查看/創(chuàng)建/更新任務(wù) |
| Slack MCP | 發(fā)送消息到頻道 |
| 文件系統(tǒng) MCP | 訪問遠(yuǎn)程服務(wù)器上的文件 |
### 9.2 Skills（技能）—— 給 AI 安裝"專業(yè)插件"
**概念解釋：**
Skills 就像給 Claude Code 安裝的各種"專業(yè) App"。比如說，默認(rèn)的 Claude Code 什么都能做，但如果你要處理 Excel 文件，裝了 "xlsx" 這個(gè) Skill 后，它會變得更專業(yè)。

**如何在 Claude Code 中使用 Skills：**
Skills 的配置存儲在 `.claude/settings.json` 文件中。你可以在這個(gè)文件中聲明要啟用的 Skills：
?```json
{
  "skills": [
    "xlsx",     // Excel 處理技能
    "docx",     // Word 處理技能
    "pptx",     // PowerPoint 處理技能
    "pdf"       // PDF 處理技能
  ]
}

// 在 .claude/settings.json 中配置
{
  "hooks": {
    // PostToolUse：在 AI 使用某個(gè)工具后觸發(fā)
    "PostToolUse": [
      {
        // 匹配器：當(dāng) AI 修改了 Java 文件時(shí)觸發(fā)
        "matcher": "Edit",
        // 鉤子：自動格式化代碼
        "hooks": [
          {
            "type": "command",
            // 執(zhí)行這個(gè)命令來格式化剛修改的 Java 代碼
            "command": "mvn spotless:apply"
          }
        ]
      }
    ]
  }
}

場景對照表
═══════════════════════════════════════════════════════════
  觸發(fā)時(shí)機(jī)          │  可以做什么
  ──────────────────┼─────────────────────────────────────
  對話開始時(shí)         │  加載項(xiàng)目信息、檢查環(huán)境
  工具使用前         │  額外安全檢查、記錄日志
  工具使用后         │  自動格式化、運(yùn)行測試、記錄變更
  AI 回復(fù)后          │  發(fā)送通知、觸發(fā) CI/CD
  對話結(jié)束時(shí)         │  清理臨時(shí)文件、生成工作報(bào)告
  文件被修改前       │  自動備份原文件

模型選擇指南
═══════════════════════════════════════════════════════════
  ┌─────────────────────────────────────────────────────────┐
  │  模型          │  適合場景           │  特點(diǎn)             │
  ├────────────────┼────────────────────┼──────────────────┤
  │  Opus 4.8      │  最復(fù)雜的任務(wù)        │  最聰明、最貴     │
  │  （旗艦?zāi)Ｐ停?   │  大型項(xiàng)目重構(gòu)        │  適合"深度思考"   │
  │                │  復(fù)雜架構(gòu)設(shè)計(jì)        │                  │
  ├────────────────┼────────────────────┼──────────────────┤
  │  Sonnet 4.6    │  日常開發(fā)            │  智能與速度的平衡  │
  │  （推薦日常用）  │  寫代碼、修 Bug      │  性價(jià)比最高       │
  │                │  中小型項(xiàng)目          │                  │
  ├────────────────┼────────────────────┼──────────────────┤
  │  Haiku 4.5     │  簡單任務(wù)            │  最快、最便宜     │
  │  （輕量模型）    │  代碼分類、格式化     │  適合高頻簡單操作  │
  │                │  簡單問答            │                  │
  └────────────────┴────────────────────┴──────────────────┘
  切換命令：
  /model opus      → 切換到 Opus（處理復(fù)雜任務(wù)時(shí)）
  /model sonnet    → 切換到 Sonnet（日常開發(fā)，默認(rèn)推薦）
  /model haiku     → 切換到 Haiku（執(zhí)行簡單重復(fù)任務(wù)時(shí)）

單個(gè) AI 處理大項(xiàng)目：
┌────────────────────────────────────────────────────┐
│  AI 一個(gè)人干活                                       │
│  任務(wù)1 → 任務(wù)2 → 任務(wù)3 → 任務(wù)4 → 任務(wù)5              │
│  耗時(shí)：所有任務(wù)的時(shí)間之和                              │
└────────────────────────────────────────────────────┘
Workflow 多 AI 并行：
┌────────────────────────────────────────────────────┐
│  AI-1 → 任務(wù)1                                      │
│  AI-2 → 任務(wù)2     ← 所有 AI 同時(shí)工作                 │
│  AI-3 → 任務(wù)3                                      │
│  AI-4 → 任務(wù)4                                      │
│  AI-5 → 任務(wù)5                                      │
│  耗時(shí)：最慢的一個(gè)任務(wù)的時(shí)間                            │
└────────────────────────────────────────────────────┘

OCP 項(xiàng)目架構(gòu)概覽
═══════════════════════════════════════════════════════════
  ┌─────────────────────────────────────────────────────────┐
  │                    瀏覽器（前端）                         │
  │              HTML + CSS + JavaScript                    │
  └────────────────────────┬────────────────────────────────┘
                           │ HTTP 請求
                           ▼
  ┌─────────────────────────────────────────────────────────┐
  │                 Spring Boot 后端                         │
  │  ┌──────────┐  ┌──────────┐  ┌──────────┐             │
  │  │Controller│→│ Service  │→│  Mapper  │              │
  │  │ 接收請求  │  │ 處理業(yè)務(wù)  │  │ 訪問數(shù)據(jù)庫│              │
  │  └──────────┘  └──────────┘  └────┬─────┘             │
  └────────────────────────────────────┼────────────────────┘
                                       │
                           ┌───────────┴───────────┐
                           ▼                       ▼
                    ┌─────────────┐         ┌─────────────┐
                    │   MySQL     │         │   Redis     │
                    │  數(shù)據(jù)庫      │         │  緩存       │
                    │  存數(shù)據(jù)      │         │  加速訪問    │
                    └─────────────┘         └─────────────┘

# 在 Claude Code 中輸入以下內(nèi)容：
> 幫我創(chuàng)建一個(gè)標(biāo)準(zhǔn)的 Spring Boot 項(xiàng)目骨架，使用 Maven 管理。
  項(xiàng)目名為 ocp-platform，包名為 com.example.ocp。
  要求：
  1. Java 版本使用 JDK 11
  2. Spring Boot 版本使用 2.7.x
  3. 包含以下依賴：
     - Spring Web（用于開發(fā) REST API）
     - MyBatis-Plus（簡化數(shù)據(jù)庫操作）
     - MySQL Connector（連接 MySQL 數(shù)據(jù)庫）
     - Lombok（簡化 Java 代碼）
     - Spring Boot Validation（參數(shù)校驗(yàn)）
  4. 創(chuàng)建標(biāo)準(zhǔn)的項(xiàng)目目錄結(jié)構(gòu)
  5. 創(chuàng)建基礎(chǔ)的配置文件 application.yml
  6. 創(chuàng)建基礎(chǔ)的工具類（如統(tǒng)一的響應(yīng)格式 Result 類）

ocp-platform/
├── pom.xml                          # Maven 項(xiàng)目配置文件
├── CLAUDE.md                        # Claude Code 項(xiàng)目說明書
├── src/
│   ├── main/
│   │   ├── java/com/example/ocp/
│   │   │   ├── OcpApplication.java  # Spring Boot 啟動類
│   │   │   ├── controller/          # 控制器包
│   │   │   ├── service/             # 服務(wù)層包
│   │   │   │   └── impl/            # 服務(wù)實(shí)現(xiàn)類
│   │   │   ├── mapper/              # 數(shù)據(jù)訪問層
│   │   │   ├── entity/              # 數(shù)據(jù)庫實(shí)體類
│   │   │   ├── dto/                 # 數(shù)據(jù)傳輸對象
│   │   │   ├── common/              # 公共類
│   │   │   │   └── Result.java      # 統(tǒng)一響應(yīng)格式
│   │   │   └── config/              # 配置類
│   │   └── resources/
│   │       ├── application.yml      # 主配置文件
│   │       └── mapper/              # MyBatis XML 映射
│   └── test/
│       └── java/com/example/ocp/    # 測試代碼

> /init

## OCP 項(xiàng)目開發(fā)規(guī)范補(bǔ)充
### API 設(shè)計(jì)規(guī)范
- 所有 API 路徑以 /api 開頭
- 使用 RESTful 風(fēng)格：
  - GET /api/users —— 查詢用戶列表
  - GET /api/users/{id} —— 查詢單個(gè)用戶
  - POST /api/users —— 創(chuàng)建用戶
  - PUT /api/users/{id} —— 更新用戶
  - DELETE /api/users/{id} —— 刪除用戶
### 數(shù)據(jù)庫規(guī)范
- 表名使用小寫字母和下劃線，如 user_order
- 字段名使用小寫字母和下劃線，如 create_time
- 每張表必須有 id（主鍵）、create_time、update_time 字段
### 測試規(guī)范
- Service 層必須寫單元測試
- Controller 層寫集成測試
- 測試覆蓋率目標(biāo)：Service 層 ≥ 80%

> 幫我實(shí)現(xiàn)用戶管理模塊，包括以下功能：
  1. 用戶注冊（賬號 + 密碼 + 郵箱）
  2. 用戶登錄（返回 JWT Token）
  3. 根據(jù) ID 查詢用戶信息
  4. 更新用戶信息（昵稱、頭像等）
  5. 密碼加密存儲（使用 BCrypt）
  6. 注冊時(shí)校驗(yàn)郵箱格式和密碼強(qiáng)度
  請?jiān)?Controller、Service、Mapper 層分別實(shí)現(xiàn)。
  所有方法都必須有詳細(xì)的中文注釋。
  為 Service 層編寫單元測試。

> 幫我實(shí)現(xiàn)商品管理模塊：
  1. 商品實(shí)體包含：商品名、描述、價(jià)格、庫存、分類、圖片URL
  2. 支持商品列表的分頁查詢（可按分類篩選、按價(jià)格排序）
  3. 支持商品詳情查詢
  4. 支持商品搜索（根據(jù)名稱模糊搜索）
  5. 管理員可以新增、修改、下架商品
  同樣實(shí)現(xiàn) Controller、Service、Mapper 三層。
  包含詳細(xì)注釋和單元測試。

> 幫我實(shí)現(xiàn)購物車模塊：
  1. 用戶可以把商品加入購物車（指定數(shù)量）
  2. 用戶可以修改購物車中商品的數(shù)量
  3. 用戶可以從購物車中刪除商品
  4. 用戶可以查看自己的購物車列表
  5. 購物車數(shù)據(jù)存儲在 Redis 中
  6. 同一個(gè)商品重復(fù)添加時(shí)，數(shù)量累加
  需要配置 Redis 連接，實(shí)現(xiàn) Redis 操作的工具類。

> 幫我實(shí)現(xiàn)訂單模塊：
  1. 用戶可以從購物車生成訂單
  2. 訂單包含：訂單號、用戶ID、商品列表、總金額、狀態(tài)
  3. 訂單狀態(tài)流轉(zhuǎn)：待支付 → 已支付 → 已發(fā)貨 → 已完成 → 已取消
  4. 用戶可以查看自己的訂單列表
  5. 用戶可以取消待支付的訂單
  6. 生成訂單時(shí)自動扣減庫存（使用數(shù)據(jù)庫事務(wù)確保數(shù)據(jù)一致性）
  7. 使用 @Transactional 注解管理事務(wù)

> 幫我實(shí)現(xiàn)全局異常處理：
  1. 創(chuàng)建自定義業(yè)務(wù)異常類 BusinessException
  2. 使用 @ControllerAdvice 實(shí)現(xiàn)全局異常攔截
  3. 不同的異常類型返回對應(yīng)的 HTTP 狀態(tài)碼和錯(cuò)誤信息
  4. 常見異常的處理：
     - 參數(shù)校驗(yàn)失敗 → 400
     - 資源不存在 → 404
     - 業(yè)務(wù)邏輯錯(cuò)誤 → 422
     - 服務(wù)器內(nèi)部錯(cuò)誤 → 500

Bug 處理流程圖
═══════════════════════════════════════════════════════════
  發(fā)現(xiàn) Bug（啟動報(bào)錯(cuò) / 功能不正常 / 測試失敗）
       │
       ▼
┌──────────────────┐
│ 把錯(cuò)誤信息完整地  │  ← 復(fù)制粘貼，不要遺漏任何信息
│ 復(fù)制給 Claude Code │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ Claude Code 分析  │
│ 錯(cuò)誤原因          │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ Claude Code 提出  │
│ 修復(fù)方案          │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ 你確認(rèn) → 修復(fù)     │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ Claude Code 運(yùn)行  │
│ 測試驗(yàn)證修復(fù)       │
└──────┬───────────┘
       │
       ▼
  測試通過？
   │    │
  是   否 → 返回分析步驟，重新調(diào)試
   │
   ▼
  Bug 已修復(fù)！

> 幫我部署這個(gè) OCP 項(xiàng)目。我的服務(wù)器環(huán)境是：
  - 操作系統(tǒng)：Linux (Ubuntu 20.04)
  - 已安裝 Docker 和 Docker Compose
  - 數(shù)據(jù)庫：MySQL 8.0
  - 需要配置 Nginx 反向代理
  請幫我：
  1. 創(chuàng)建 Dockerfile（把項(xiàng)目打包成 Docker 鏡像）
  2. 創(chuàng)建 docker-compose.yml（編排 MySQL + Redis + 應(yīng)用）
  3. 創(chuàng)建 Nginx 配置文件
  4. 生成部署腳本 deploy.sh
  5. 寫出詳細(xì)的部署步驟文檔 DEPLOY.md

# Dockerfile —— 把 Java 應(yīng)用打包成容器鏡像
# 使用官方的 OpenJDK 11 鏡像作為基礎(chǔ)
FROM openjdk:11-jre-slim
# 設(shè)置容器內(nèi)的工作目錄
WORKDIR /app
# 把編譯好的 jar 包復(fù)制到容器中
COPY target/ocp-platform-1.0.0.jar app.jar
# 暴露 8080 端口（Spring Boot 默認(rèn)端口）
EXPOSE 8080
# 容器啟動時(shí)執(zhí)行的命令
ENTRYPOINT ["java", "-jar", "app.jar"]

OCP 項(xiàng)目從零到部署的完整對話流程
═══════════════════════════════════════════════════════════
  第 1 步：創(chuàng)建項(xiàng)目骨架
  "幫我創(chuàng)建一個(gè)標(biāo)準(zhǔn)的 Spring Boot 項(xiàng)目骨架……"
                    │
                    ▼
  第 2 步：初始化 CLAUDE.md
  /init（讓 Claude Code 理解你的項(xiàng)目）
                    │
                    ▼
  第 3 步：逐個(gè)實(shí)現(xiàn)功能模塊
  ┌─────────────────────────────────────┐
  │ 用戶模塊 → 商品模塊 → 購物車模塊       │
  │ → 訂單模塊 → 異常處理 → 日志配置       │
  └─────────────────────────────────────┘
  每完成一個(gè)模塊，運(yùn)行測試驗(yàn)證
                    │
                    ▼
  第 4 步：集成測試
  "幫我寫一個(gè)端到端的集成測試……"
                    │
                    ▼
  第 5 步：部署上線
  "幫我創(chuàng)建 Dockerfile 和部署腳本……"
                    │
                    ▼
  ? 項(xiàng)目完成！

學(xué)習(xí)成果檢查清單
═══════════════════════════════════════════════════════════
  □ 理解 Claude Code 是什么，能做什么
  □ 獨(dú)立完成 Claude Code 的安裝和配置
  □ 掌握基礎(chǔ)的對話和指令技巧
  □ 理解上下文（Context）、Token、工具（Tools）等核心概念
  □ 能夠用自然語言讓 AI 讀取、搜索、修改代碼文件
  □ 理解 CLAUDE.md 文件的作用
  □ 能夠管理一個(gè)完整的多文件項(xiàng)目
  □ 了解 MCP、Skills、Hooks 等高級功能
  □ 能夠從零開始完成一個(gè) OCP 項(xiàng)目的開發(fā)
  □ 知道遇到問題該如何排查

Claude Code 五條黃金法則
════════════════════════════════════════════════════════════
  1??  你是導(dǎo)演，AI 是演員
      你負(fù)責(zé)告訴 AI "要演什么"，AI 負(fù)責(zé)具體的"表演"
      你不需要知道怎么寫代碼，但需要清楚地描述你想要的結(jié)果
  2??  越具體，結(jié)果越好
      "幫我寫個(gè)用戶登錄功能" 不如
      "幫我寫一個(gè)用戶登錄接口，接收用戶名和密碼，
       驗(yàn)證成功后返回 JWT Token，失敗返回錯(cuò)誤信息"
  3??  迭代比一次完美更重要
      先讓 AI 做出一個(gè)能用的版本，然后再逐步優(yōu)化
      不要試圖第一次就把所有細(xì)節(jié)都說清楚
  4??  善用 AI 的眼睛
      讓 AI 幫你讀代碼、搜代碼、分析代碼
      你只需要做決策
  5??  保持"人在回路中"
      AI 是強(qiáng)大的工具，但最終的決定權(quán)在你手里
      審查 AI 的修改，理解 AI 的邏輯，做出自己的判斷

進(jìn)階學(xué)習(xí)路徑
═══════════════════════════════════════════════════════════
  初學(xué)者 ──→ 本教程 ──→ 用 Claude Code 做一個(gè)小項(xiàng)目
                            │
                            ▼
                    閱讀 Claude Code 官方文檔
                    了解更高級的配置選項(xiàng)
                            │
                            ▼
                    學(xué)習(xí) MCP 協(xié)議
                    連接 GitHub、數(shù)據(jù)庫等外部服務(wù)
                            │
                            ▼
                    編寫自定義 Skills
                    讓 Claude Code 更適配你的工作流
                            │
                            ▼
                    配置 Hooks
                    實(shí)現(xiàn)自動化工作流
                            │
                            ▼
                    掌握 Workflow
                    實(shí)現(xiàn)多 AI 并行處理復(fù)雜任務(wù)