Claude Code settings.json 在哪？專案、使用者與權限設定路徑整理

最後更新：2026-05-24

如果你搜尋 Claude Code settings.json 在哪，通常不是想研究設定檔本身。

你多半是遇到這幾種狀況：

• 每次 Claude Code 都一直問權限
• 你想把 acceptEdits 設成預設
• 你想把常用指令加入 allowlist
• 你不確定要改 ~/.claude/settings.json 還是專案裡的 .claude/settings.json
• 你怕把個人設定 commit 到 repo

先給結論：

如果你還不熟 Claude Code 權限模式，先看母文：[[2026-05-19 Claude Code 權限怎麼設？permission modes、allowlist 與安全設定完整整理（2026）|Claude Code 權限怎麼設]]。

Claude Code settings.json 有哪幾種？

Claude Code 的設定是分層讀取的，不是只有單一檔案。

最容易搞錯的是第二個和第三個。

.claude/settings.json 比較像團隊公約。
.claude/settings.local.json 比較像你自己在這台電腦上的便利貼。

如果你在公司或客戶專案工作，我會保守一點：

① 團隊需要共享的規則才放 .claude/settings.json
② 你自己的習慣放 .claude/settings.local.json
③ 高風險 allowlist 不要隨便 commit

macOS / Linux / Windows 路徑對照

官方文件也提醒，Windows 的 ~/.claude 對應到 %USERPROFILE%\.claude。

權限設定應該放在哪裡？

如果你要控制 Claude Code 可以做什麼，通常會設定 permissions。

常見像這樣：

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(git status)",
      "Bash(npm run build)"
    ],
    "deny": [
      "Read(.env)",
      "Read(.env.*)"
    ]
  }
}

這段代表：

我的建議是：

• 第一次用陌生 repo：先不要急著設很大
• 日常小改：可以用 acceptEdits
• 敏感專案：優先補 deny
• 不要把 bypassPermissions 當作日常模式

全域設定和專案設定怎麼選？

你可以用這個判斷：

很多權限問題不是 Claude Code 壞掉，而是設定放錯地方。

例如你把只適合自己電腦的 allowlist commit 進 repo，其他人可能根本不能用。
或者你以為全域設定會覆蓋一切，但專案裡還有更具體的設定在影響結果。

為什麼 settings.json 設了還是一直問？

常見原因有 4 個：

我的做法是先從最小 allowlist 開始。

例如先只允許：

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(npm run build)",
      "Bash(npm test)"
    ]
  }
}

等你確認專案流程真的固定，再慢慢放寬。

常見問題 FAQ

Claude Code settings.json 在哪裡？

使用者全域設定在 ~/.claude/settings.json，專案共享設定在 專案/.claude/settings.json，專案個人設定在 專案/.claude/settings.local.json。

settings.local.json 可以 commit 嗎？

不建議。它比較適合放你個人的本機偏好、實驗 allowlist 或不適合團隊共享的設定。

permissions.defaultMode 要放哪裡？

放在 settings 檔的 permissions.defaultMode 裡。若是個人偏好，放 ~/.claude/settings.json；若是團隊共識，才放專案 .claude/settings.json。

Claude Code 一直問權限，是 settings.json 沒生效嗎？

不一定。可能是設定放錯層級、allow 規則沒有命中、專案有其他設定覆蓋，或目前動作仍被判定為高風險。

資料來源

資料最後查核日期：2026-05-24

• Claude Code Docs: Settings：https://code.claude.com/docs/en/settings
• Claude Code Docs: Configure permissions：https://code.claude.com/docs/en/permissions
• Claude Code Docs: Explore the .claude directory：https://code.claude.com/docs/en/claude-directory