河狸老師 Podcast Architecture Lab Mandarin Systems Podcast

河狸老師講 Claude Code

河狸老師把 Claude Code 講成團隊真的能落地的工作流。

這不是泛 AI 快訊節目。河狸老師每集只拆一個真的會改變團隊 workflow 的主題，用中文講清楚 Claude Code 的規則、權限、hooks、skills、 sub-agents 與 context 設計，讓工程團隊能直接把內容帶回 repo 和工作流裡落地。

每週一集 25-35 分鐘 Mandarin-first 定義 + 邊界 + 反模式
河狸老師講解 Claude Code 架構
河狸老師把 `claude.md`、hooks、skills、agents、context 畫進同一張教學板。

Host Persona

河狸老師

不帶你背功能表，而是用系統圖、責任邊界、團隊 pattern 與反模式， 把 Claude Code 講成人真的能拿去做事的工作法。

Support Lane

支持節目 / 贊助合作

想支持節目、談單集或季贊助，或投遞河狸老師下一集該拆的主題， 直接走這個入口。贊助不買結論，只買一個清楚、誠實、對工程團隊有用的曝光位置。

查看贊助頁 聯絡合作 Apple Podcasts

1. Channel Format

用固定承諾、固定節奏、固定支持入口經營頻道

這裡採用的是內容頻道的經營骨架，不是別人的口氣。承諾要清楚， 更新要可預期，支持與合作入口要每次都在，但不能壓過技術內容本身。

Promise

每一集都要留下四個可帶走的東西

  • 一個清楚定義
  • 一條責任邊界
  • 一個 team design pattern
  • 至少一個常見反模式

Cadence

深度教學，不做每天快報

與短平快的 AI 快訊不同，河狸老師維持每週一集、25 到 35 分鐘的深度教學節奏。第一季先把 12 集的系統地圖走完，再持續疊代。

Sponsor Surface

贊助合作有獨立頁面，不塞進節目主文案

節目品牌先把內容講清楚，合作資訊與品牌邊界另外走獨立 sponsor page。

sponsor page contact Apple

2. Core Model

五層架構總圖

先定義每個機制屬於哪一層，再談檔案、規則與團隊設計。這能避免把 `CLAUDE.md`、settings、hooks、skills 全部講成同一種東西。

Claude Code five-layer architecture map
五層模型把政策、確定性、自訂能力、委派、以及 context 管理拆開。

Current Layer

控制平面

放政策和持久規則，例如 `CLAUDE.md`、rules、settings、permissions。

    3. Mechanism Comparison

    不是所有規則都該寫進 `CLAUDE.md`

    這一區故意把三個最常混在一起的機制攤平比較，避免教學時把「文字規則」誤講成「可執行的確定性限制」。

    Surface 適合放什麼 不適合放什麼 核心風險
    `CLAUDE.md` 持久規則、工作節奏、檔案指引 太長的 SOP、需要程式保證的限制 規則互相衝突、越寫越像教科書
    settings scope 與共享設定 教學內容、工作方法論 scope 漂移、commit 了本該 local 的東西
    hooks 確定性檢查、阻擋危險操作、驗收 gate 需要人判斷的模糊評論 把所有事情都硬塞進 shell guardrail

    4. Interactive Lab

    Scope Switcher + Context Budget Demo

    這個實驗頁面把兩個常見誤解拆開：設定 scope 是「放哪裡」，context budget 是「何時該清掉或文件化」。

    Scope Switcher

    建議檔案位置

    ~/.claude/settings.json

    適合跨專案偏好的預設值，不適合放專案專屬工作流。

    Context Budget

    45%

    還在安全區，可以繼續，但已經該開始把中間決策寫回檔案。

    5. Episode Entry

    EP01：控制架構總覽

    這是第一集的網站入口。它把問題動機、五層模型、反模式與最小可行檔案樹串成一條清楚路徑。

    已上線首集 · 網站互動頁配套

    從「一堆 Claude Code 功能」切換成「一套可控的團隊系統」

    • 一句話定義五層模型
    • 三個最常見混用錯誤
    • 最小可行 repo 範本
    打開 EP01 頁面 直接收聽

    6. Season One

    12 集內容導覽

    第一季從五層系統模型開始，依序拆控制面、自動化、能力、協作與 context 治理，最後收在 GitHub Actions 與發佈自動化。

    EP01

    控制架構總覽

    先把 Claude Code 講成五層系統，而不是功能清單。

     EP02

    CLAUDE.md 與記憶

    拆解持久規則、記憶層次與 import 策略。

     EP03

    Settings 與作用域

    分清 user、project、local、managed 的責任邊界。

     EP04

    Permissions 與模式

    把允許清單、審批疲勞與工作流安全拆開看。

     EP05

    Hooks

    把流程限制從文字升級成可執行的 guardrail。

     EP06

    Workflow Acceptance

    用 lifecycle hook 設計 stop gate、handoff 與驗收。

     EP07

    Skills

    把重複流程封裝起來，而不是把 root prompt 越寫越厚。

     EP08

    Sub-agents

    按 ownership 與 context 隔離來設計委派。

     EP09

    Plugins

    把團隊能力做成可攜式模板，不只侷限單一 repo。

     EP10

    MCP

    延伸外部工具時，同時管理 trust boundary 與 token 成本。

     EP11

    Context 與 Compact

    把 context 當資源管理，而不是越多越好。

     EP12

    GitHub Actions

    把 repo 自動化接進交付、驗收與發佈。