Episode 03 Scopes

Claude Code Deep Dive

Settings 與作用域

第三集把 user、project、local、managed 四種 scope 講清楚,讓團隊知道每個設定應該落在哪裡。

Listen Now

收聽 EP03 與下載講義

Episode Promise

這一集解三件事

1. 一句話模型

Settings 定義配置放哪裡、誰擁有它,scope 決定 shared default、local experiment、org policy 各自的位置。

2. 反模式

最常見錯誤不是「沒設定」,而是把本地實驗和團隊共識混在一起。

Takeaways

三個重點

先判斷 owner 改設定前先問這個值屬於誰,再決定要不要進 repo。 沒分清楚 scope 就先動手 把 scope 當決策線
keep local local 本機測試和臨時實驗不要污染 shared config。 把 temporary 當成 permanent local 只做 local 的事
shared config 要明確 越是團隊共用,越要讓每個人一眼看出它屬於哪一層。 同一個決策重複出現在多個 scope 把 project 和 managed 分清楚

Minimum Viable Template

最小可行檔案樹

ai-edu-media/
  .claude/
    settings.json
    settings.local.json
  CLAUDE.md
  architecture/
    file-taxonomy.md
  research/
    topic-notes/settings-and-permissions.md

這一集的工作不是把所有 scope 都背下來,而是讓團隊有一條一致的判斷線。

Why It Matters

設定不是數值問題,是責任問題

User 與 Project

user scope 是跨專案的個人預設,project scope 是 repo 共識。兩者的任務不同,所以不能互相代替。

Local 與 Managed

local scope 是暫時性或機器特定的行為,managed scope 是 org policy。只要把這兩層混掉,團隊就會失去治理邊界。