Claude Code 設定

Claude Code 提供各種設定來配置其行為以滿足您的需求。您可以在使用互動式 REPL 時執行 /config 命令來配置 Claude Code。

​

設定檔案

settings.json 檔案是我們透過階層式設定來配置 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"
  }
}

​

可用設定

settings.json 支援多個選項：

​

權限設定

​

設定優先順序

設定按優先順序套用（從高到低）：

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
• 優先順序：較高層級的配置（企業）覆蓋較低層級的配置（使用者/專案）
• 繼承：設定會合併，更具體的設定會添加到或覆蓋更廣泛的設定

​

系統提示可用性

​

排除敏感檔案

要防止 Claude Code 存取包含敏感資訊的檔案（例如 API 金鑰、機密、環境檔案），請在您的 .claude/settings.json 檔案中使用 permissions.deny 設定：

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

這取代了已棄用的 ignorePatterns 配置。符合這些模式的檔案對 Claude Code 完全不可見，防止任何意外暴露敏感資料。

​

子代理配置

Claude Code 支援可在使用者和專案層級配置的自訂 AI 子代理。這些子代理儲存為帶有 YAML 前言的 Markdown 檔案：

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

子代理檔案定義具有自訂提示和工具權限的專門 AI 助手。在子代理文件中了解更多關於建立和使用子代理的資訊。

​

環境變數

Claude Code 支援以下環境變數來控制其行為：

​

配置選項

要管理您的配置，請使用以下命令：

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

預設情況下，config 會更改您的專案配置。要管理您的全域配置，請使用 --global（或 -g）標誌。

​

全域配置

要設定全域配置，請使用 claude config set -g <key> <value>：

​

Claude 可用的工具

Claude Code 可以存取一組強大的工具，幫助它理解和修改您的程式碼庫：

權限規則可以使用 /allowed-tools 或在權限設定中配置。另請參見工具特定權限規則。

​

使用 hooks 擴展工具

您可以使用 Claude Code hooks 在任何工具執行前後運行自訂命令。

例如，您可以在 Claude 修改 Python 檔案後自動運行 Python 格式化程式，或透過阻止對某些路徑的 Write 操作來防止修改生產配置檔案。

​

另請參見

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