Claude Code 設定

​

設定檔案

• 使用者設定 定義在 ~/.claude/settings.json 中，適用於所有專案。
• 專案設定 儲存在您的專案目錄中：
  • .claude/settings.json 用於檢入原始碼控制並與團隊共享的設定
  • .claude/settings.local.json 用於不檢入的設定，適用於個人偏好和實驗。Claude Code 會在建立時配置 git 忽略 .claude/settings.local.json。
• 對於 Claude Code 的企業部署，我們也支援企業管理政策設定。這些設定優先於使用者和專案設定。系統管理員可以將政策部署到：
  • macOS：/Library/Application Support/ClaudeCode/managed-settings.json
  • Linux 和 WSL：/etc/claude-code/managed-settings.json
  • Windows：C:\ProgramData\ClaudeCode\managed-settings.json

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

可用設定

​

權限設定

​

設定優先順序

1. 企業管理政策（managed-settings.json）
   • 由 IT/DevOps 部署
   • 無法被覆蓋
2. 命令列參數
   • 特定會話的臨時覆蓋
3. 本地專案設定（.claude/settings.local.json）
   • 個人專案特定設定
4. 共享專案設定（.claude/settings.json）
   • 原始碼控制中的團隊共享專案設定
5. 使用者設定（~/.claude/settings.json）
   • 個人全域設定

​

配置系統的重點

• 記憶檔案（CLAUDE.md）：包含 Claude 在啟動時載入的指令和上下文
• 設定檔案（JSON）：配置權限、環境變數和工具行為
• 斜線命令：可在會話期間使用 /command-name 調用的自訂命令
• MCP 伺服器：使用額外工具和整合擴展 Claude Code
• 優先順序：較高層級的配置（企業）覆蓋較低層級的配置（使用者/專案）
• 繼承：設定會合併，更具體的設定會添加到或覆蓋更廣泛的設定

​

系統提示可用性

​

排除敏感檔案

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

​

子代理配置

• 使用者子代理：~/.claude/agents/ - 在您的所有專案中可用
• 專案子代理：.claude/agents/ - 專案特定，可與您的團隊共享

​

環境變數

​

配置選項

• 列出設定：claude config list
• 查看設定：claude config get <key>
• 更改設定：claude config set <key> <value>
• 推送到設定（對於清單）：claude config add <key> <value>
• 從設定中移除（對於清單）：claude config remove <key> <value>

​

全域配置

​

Claude 可用的工具

​

使用 hooks 擴展工具

​

另請參見

• 身分識別和存取管理 - 了解 Claude Code 的權限系統
• IAM 和存取控制 - 企業政策管理
• 疑難排解 - 常見配置問題的解決方案