Claude Code 設定

​

設定檔案

• 使用者設定定義在 ~/.claude/settings.json 中，適用於所有專案。
• 專案設定儲存在您的專案目錄中：
  • .claude/settings.json 用於簽入原始碼控制並與您的團隊共享的設定
  • .claude/settings.local.json 用於未簽入的設定，適用於個人偏好和實驗。Claude Code 在建立 .claude/settings.local.json 時會將其設定為 git 忽略。
• 對於 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
• 企業部署也可以設定受管 MCP 伺服器，這會覆蓋使用者設定的伺服器。請參閱企業 MCP 設定：
  • macOS：/Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux 和 WSL：/etc/claude-code/managed-mcp.json
  • Windows：C:\ProgramData\ClaudeCode\managed-mcp.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"
  }
}

​

可用的設定

​

權限設定

​

沙箱設定

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Read 拒絕規則在沙箱中封鎖檔案讀取
• Edit 允許規則允許檔案寫入（除了預設值，例如目前工作目錄）
• Edit 拒絕規則在允許的路徑內封鎖寫入

• WebFetch 允許規則允許網路網域
• WebFetch 拒絕規則封鎖網路網域

​

設定優先順序

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/ - 特定於您的專案，可與您的團隊共享

​

外掛程式設定

​

外掛程式設定

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/claude-plugins"
    }
  }
}

​

enabledPlugins

• 使用者設定 (~/.claude/settings.json)：個人外掛程式偏好
• 專案設定 (.claude/settings.json)：與團隊共享的專案特定外掛程式
• 本機設定 (.claude/settings.local.json)：每台機器的覆蓋（未提交）

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. 當團隊成員信任該資料夾時，系統會提示他們安裝市場
2. 然後系統會提示團隊成員從該市場安裝外掛程式
3. 使用者可以跳過不需要的市場或外掛程式（儲存在使用者設定中）
4. 安裝遵守信任邊界並需要明確同意

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/security/plugins.git"
      }
    }
  }
}

• github：GitHub 儲存庫（使用 repo）
• git：任何 git URL（使用 url）
• directory：本機檔案系統路徑（使用 path，僅用於開發）

​

管理外掛程式

• 瀏覽市場中的可用外掛程式
• 安裝/解除安裝外掛程式
• 啟用/停用外掛程式
• 檢視外掛程式詳細資訊（提供的命令、代理、hooks）
• 新增/移除市場

​

環境變數

​

Claude 可用的工具

​

使用 hooks 擴展工具

​

另請參閱

• 身份和存取管理 - 了解 Claude Code 的權限系統
• IAM 和存取控制 - 企業原則管理
• 疑難排解 - 常見設定問題的解決方案