Claude Code 設定

使用全域和專案層級設定以及環境變數來設定 Claude Code。

Claude Code 提供多種設定選項，可根據您的需求配置其行為。您可以在使用互動式 REPL 時執行 /config 命令來設定 Claude Code，這會開啟一個標籤式設定介面，您可以在其中查看狀態資訊並修改設定選項。

設定範圍

Claude Code 使用範圍系統來決定設定的適用位置和共享對象。了解範圍可幫助您決定如何為個人使用、團隊協作或企業部署設定 Claude Code。

可用的範圍

何時使用各個範圍

Managed 範圍用於：

• 必須在整個組織範圍內強制執行的安全政策
• 無法覆蓋的合規要求
• 由 IT/DevOps 部署的標準化設定

User 範圍最適合：

• 您想在任何地方使用的個人偏好設定（主題、編輯器設定）
• 您在所有專案中使用的工具和 plugins
• API 金鑰和身份驗證（安全儲存）

Project 範圍最適合：

• 團隊共享的設定（權限、hooks、MCP servers）
• 整個團隊應該擁有的 plugins
• 跨協作者標準化工具

Local 範圍最適合：

• 特定專案的個人覆蓋
• 在與團隊共享之前測試設定
• 對其他人不適用的機器特定設定

範圍如何互動

當相同的設定在多個範圍中配置時，更具體的範圍優先：

1. Managed（最高）- 無法被任何東西覆蓋
2. 命令列引數 - 臨時工作階段覆蓋
3. Local - 覆蓋專案和使用者設定
4. Project - 覆蓋使用者設定
5. User（最低）- 當沒有其他東西指定設定時適用

例如，如果使用者設定中允許某個權限，但專案設定中拒絕該權限，則專案設定優先，該權限被阻止。

哪些功能使用範圍

範圍適用於許多 Claude Code 功能：

在 Windows 上，顯示為 ~/.claude 的路徑會解析為 %USERPROFILE%\.claude。

設定檔案

settings.json 檔案是透過分層設定來設定 Claude Code 的官方機制：

• 使用者設定在 ~/.claude/settings.json 中定義，適用於所有專案。

• 專案設定儲存在您的專案目錄中：

  • .claude/settings.json 用於簽入原始碼控制並與您的團隊共享的設定
  • .claude/settings.local.json 用於未簽入的設定，適用於個人偏好和實驗。Claude Code 將在建立時設定 git 以忽略 .claude/settings.local.json。

• Managed 設定：對於需要集中控制的組織，Claude Code 支援多種 managed 設定的傳遞機制。所有機制都使用相同的 JSON 格式，無法被使用者或專案設定覆蓋：

  • 伺服器管理的設定：透過 Claude.ai 管理員主控台從 Anthropic 的伺服器傳遞。請參閱伺服器管理的設定。

  • MDM/OS 層級政策：透過 macOS 和 Windows 上的原生裝置管理傳遞：

    • macOS：com.anthropic.claudecode managed preferences 網域。plist 的頂層金鑰鏡像 managed-settings.json，巢狀設定為字典，陣列為 plist 陣列。透過 Jamf、Iru (Kandji) 或類似 MDM 工具中的設定檔案部署。
    • Windows：HKLM\SOFTWARE\Policies\ClaudeCode 登錄機碼，其中包含 Settings 值（REG_SZ 或 REG_EXPAND_SZ）包含 JSON（透過群組原則或 Intune 部署）
    • Windows（使用者層級）：HKCU\SOFTWARE\Policies\ClaudeCode（最低政策優先順序，僅在沒有管理員層級來源時使用）

  • 檔案型：managed-settings.json 和 managed-mcp.json 部署到系統目錄：

    • macOS：/Library/Application Support/ClaudeCode/
    • Linux 和 WSL：/etc/claude-code/
    • Windows：C:\Program Files\ClaudeCode\

    檔案型 managed 設定也支援在與 managed-settings.json 相同的系統目錄中的 managed-settings.d/ 放入目錄。這讓不同的團隊可以部署獨立的政策片段，而無需協調對單一檔案的編輯。

    遵循 systemd 慣例，managed-settings.json 首先作為基礎合併，然後放入目錄中的所有 *.json 檔案按字母順序排序並合併在頂部。對於純量值，後面的檔案會覆蓋前面的檔案；陣列會連接並去重；物件會深度合併。以 . 開頭的隱藏檔案會被忽略。

    使用數字前綴來控制合併順序，例如 10-telemetry.json 和 20-security.json。

  請參閱 managed 設定 和 Managed MCP 設定 以取得詳細資訊。

  此儲存庫包含 Jamf、Iru (Kandji)、Intune 和群組原則的入門部署範本。使用這些作為起點，並根據您的需求進行調整。

• 其他設定儲存在 ~/.claude.json 中。此檔案包含您的 OAuth 工作階段、MCP server 設定（用於使用者和本機範圍）、每個專案的狀態（允許的工具、信任設定）和各種快取。專案範圍的 MCP servers 分別儲存在 .mcp.json 中。

{
  "$schema": "https://json.schemastore.org/claude-code-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"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

上面範例中的 $schema 行指向 Claude Code 設定的官方 JSON 架構。將其新增到您的 settings.json 可在 VS Code、Cursor 和任何其他支援 JSON 架構驗證的編輯器中啟用自動完成和內嵌驗證。

已發佈的架構會定期更新，可能不包含最新 CLI 版本中新增的設定，因此最近記錄的欄位上的驗證警告不一定表示您的設定無效。

可用的設定

settings.json 支援多個選項：

全域設定設定

這些設定儲存在 ~/.claude.json 中，而不是 settings.json。將它們新增到 settings.json 將觸發架構驗證錯誤。

Worktree 設定

設定 --worktree 如何建立和管理 git worktrees。

若要將 gitignored 檔案（如 .env）複製到新的 worktrees，請改用專案根目錄中的 .worktreeinclude 檔案，而不是設定。

權限設定

權限規則語法

權限規則遵循 Tool 或 Tool(specifier) 的格式。規則按順序評估：首先是拒絕規則，然後是詢問，最後是允許。第一個匹配的規則獲勝。

快速範例：

如需完整的規則語法參考，包括萬用字元行為、Read、Edit、WebFetch、MCP 和 Agent 規則的工具特定模式，以及 Bash 模式的安全限制，請參閱權限規則語法。

Sandbox 設定

設定進階 sandboxing 行為。Sandboxing 將 bash 命令與您的檔案系統和網路隔離。請參閱 Sandboxing 以了解詳細資訊。

Sandbox 路徑前綴

filesystem.allowWrite、filesystem.denyWrite、filesystem.denyRead 和 filesystem.allowRead 中的路徑支援這些前綴：

較舊的 //path 前綴用於絕對路徑仍然有效。如果您之前使用單斜線 /path 期望專案相對解析，請切換到 ./path。此語法與讀取和編輯權限規則不同，後者使用 //path 用於絕對和 /path 用於專案相對。Sandbox 檔案系統路徑使用標準慣例：/tmp/build 是絕對路徑。

設定範例：

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
      "deniedDomains": ["uploads.github.com"],
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  }
}

檔案系統和網路限制可以透過兩種合併在一起的方式設定：

• sandbox.filesystem 設定（如上所示）：在 OS 層級 sandbox 邊界控制路徑。這些限制適用於所有子流程命令（例如 kubectl、terraform、npm），而不僅僅是 Claude 的檔案工具。
• 權限規則：使用 Edit 允許/拒絕規則控制 Claude 的檔案工具存取，Read 拒絕規則阻止讀取，WebFetch 允許/拒絕規則控制網路網域。這些規則中的路徑也會合併到 sandbox 設定中。

歸屬設定

Claude Code 將歸屬新增到 git 提交和拉取請求。這些分別設定：

• 提交預設使用 git trailers（如 Co-Authored-By），可以自訂或停用
• 拉取請求說明是純文字

預設提交歸屬：

🤖 Generated with [Claude Code](https://claude.com/claude-code)

   Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

預設拉取請求歸屬：

🤖 Generated with [Claude Code](https://claude.com/claude-code)

範例：

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": ""
  }
}

檔案建議設定

為 @ 檔案路徑自動完成設定自訂命令。內建檔案建議使用快速檔案系統遍歷，但大型 monorepos 可能受益於專案特定的索引，例如預先建立的檔案索引或自訂工具。

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

該命令使用與 hooks 相同的環境變數執行，包括 CLAUDE_PROJECT_DIR。它透過 stdin 接收包含 query 欄位的 JSON：

{"query": "src/comp"}

將換行符分隔的檔案路徑輸出到 stdout（目前限制為 15）：

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

範例：

#!/bin/bash
query=$(cat | jq -r '.query')
your-repo-file-index --query "$query" | head -20

Hook 設定

這些設定控制允許執行哪些 hooks 以及 HTTP hooks 可以存取的內容。allowManagedHooksOnly 設定只能在 managed 設定中設定。URL 和環境變數白名單可以在任何設定層級設定，並跨來源合併。

當 allowManagedHooksOnly 為 true 時的行為：

• 載入 Managed hooks 和 SDK hooks
• 從在 managed 設定 enabledPlugins 中強制啟用的 plugins 載入 Hooks。這讓管理員透過組織 marketplace 分發經過審查的 hooks，同時阻止其他所有內容。信任由完整 plugin@marketplace ID 授予，因此來自不同 marketplace 的同名 plugin 保持被阻止
• 使用者 hooks、專案 hooks 和所有其他 plugin hooks 被阻止

限制 HTTP hook URL：

限制 HTTP hooks 可以針對的 URL。支援 * 作為匹配的萬用字元。定義陣列時，針對不匹配 URL 的 HTTP hooks 會被無聲地阻止。主機名稱匹配不區分大小寫，並忽略尾部 FQDN 點，符合 DNS 語義。

{
  "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}

限制 HTTP hook 環境變數：

限制 HTTP hooks 可以插入到標頭值中的環境變數名稱。每個 hook 的有效 allowedEnvVars 是其自己清單與此設定的交集。

{
  "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}

設定優先順序

設定按優先順序順序應用。從最高到最低：

1. Managed 設定（伺服器管理、MDM/OS 層級政策或 managed 設定）

   • 由 IT 透過伺服器傳遞、MDM 設定檔案、登錄政策或 managed 設定檔案部署的政策
   • 無法被任何其他層級覆蓋，包括命令列引數
   • 在 managed 層級內，優先順序為：伺服器管理 > MDM/OS 層級政策 > 檔案型（managed-settings.d/*.json + managed-settings.json）> HKCU 登錄（僅限 Windows）。僅使用一個 managed 來源；來源不合併跨層級。在檔案型層級內，放入檔案和基礎檔案會合併在一起。

2. 命令列引數

   • 特定工作階段的臨時覆蓋。JSON 透過 --settings <file-or-json> 傳遞會與檔案型設定合併，使用與其他層級相同的規則：此處設定的金鑰會覆蓋本機、專案或使用者設定中的相同金鑰，省略金鑰會保留較低層級的值

3. 本機專案設定（.claude/settings.local.json）

   • 個人專案特定設定

4. 共享專案設定（.claude/settings.json）

   • 原始碼控制中的團隊共享專案設定

5. 使用者設定（~/.claude/settings.json）

   • 個人全域設定

此階層確保組織政策始終被強制執行，同時仍允許團隊和個人自訂其體驗。無論您從 CLI、VS Code 擴充功能或 JetBrains IDE 執行 Claude Code，相同的優先順序都適用。

例如，如果您的使用者設定允許 Bash(npm run *)，但專案的共享設定拒絕它，則專案設定優先，命令被阻止。

驗證使用中的設定

在 Claude Code 內執行 /status 以查看哪些設定來源處於使用中以及它們來自何處。輸出顯示每個設定層（managed、使用者、專案）及其來源，例如 Enterprise managed settings (remote)、Enterprise managed settings (plist)、Enterprise managed settings (HKLM)、Enterprise managed settings (HKCU) 或 Enterprise managed settings (file)。如果設定檔案包含錯誤，/status 會報告問題，以便您可以修復它。

設定系統的關鍵要點

• 記憶檔案（CLAUDE.md）：包含 Claude 在啟動時載入的指示和內容
• 設定檔案（JSON）：設定權限、環境變數和工具行為
• Skills：可以使用 /skill-name 叫用或由 Claude 自動載入的自訂提示
• MCP servers：使用其他工具和整合擴展 Claude Code
• 優先順序：較高層級的設定（Managed）覆蓋較低層級的設定（User/Project）
• 繼承：設定會合併，更具體的設定新增到或覆蓋更廣泛的設定

系統提示

Claude Code 的內部系統提示未發佈。若要新增自訂指示，請使用 CLAUDE.md 檔案或 --append-system-prompt 旗標。

排除敏感檔案

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

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

這取代了已棄用的 ignorePatterns 設定。符合這些模式的檔案會從檔案發現和搜尋結果中排除，並拒絕對這些檔案的讀取操作。

Subagent 設定

Claude Code 支援可在使用者和專案層級設定的自訂 AI subagents。這些 subagents 儲存為具有 YAML frontmatter 的 Markdown 檔案：

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

Subagent 檔案定義具有自訂提示和工具權限的專門 AI 助手。在 subagents 文件中深入了解建立和使用 subagents。

Plugin 設定

Claude Code 支援 plugin 系統，可讓您使用 skills、agents、hooks 和 MCP servers 擴展功能。Plugins 透過 marketplaces 分發，可以在使用者和儲存庫層級設定。

Plugin 設定

settings.json 中的 plugin 相關設定：

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

enabledPlugins

控制啟用哪些 plugins。格式："plugin-name@marketplace-name": true/false

範圍：

• 使用者設定（~/.claude/settings.json）：個人 plugin 偏好設定
• 專案設定（.claude/settings.json）：與團隊共享的專案特定 plugins
• 本機設定（.claude/settings.local.json）：每台機器的覆蓋（未提交）
• Managed 設定（managed-settings.json）：組織範圍的政策覆蓋，在所有範圍阻止安裝並從 marketplace 隱藏 plugin

範例：

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

extraKnownMarketplaces

定義應為儲存庫提供的其他 marketplaces。通常在儲存庫層級設定中使用，以確保團隊成員有權存取所需的 plugin 來源。

當儲存庫包含 extraKnownMarketplaces 時：

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

範例：

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

Marketplace 來源類型：

• github：GitHub 儲存庫（使用 repo）
• git：任何 git URL（使用 url）
• directory：本機檔案系統路徑（使用 path，僅用於開發）
• hostPattern：正規表達式模式以符合 marketplace 主機（使用 hostPattern）
• settings：直接在 settings.json 中宣告的內嵌 marketplace，無需單獨的託管儲存庫（使用 name 和 plugins）

使用 source: 'settings' 宣告一小組 plugins，無需設定託管 marketplace 儲存庫。此處列出的 Plugins 必須參考外部來源，例如 GitHub 或 npm。您仍需要在 enabledPlugins 中分別啟用每個 plugin。

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "settings",
        "name": "team-tools",
        "plugins": [
          {
            "name": "code-formatter",
            "source": {
              "source": "github",
              "repo": "acme-corp/code-formatter"
            }
          }
        ]
      }
    }
  }
}

strictKnownMarketplaces

Managed 設定僅限：控制使用者可以新增和安裝 plugins 的 plugin marketplaces。此設定只能在 managed 設定中設定，並為管理員提供對 marketplace 來源的嚴格控制。

Managed 設定檔案位置：

• macOS：/Library/Application Support/ClaudeCode/managed-settings.json
• Linux 和 WSL：/etc/claude-code/managed-settings.json
• Windows：C:\Program Files\ClaudeCode\managed-settings.json

關鍵特性：

• 僅在 managed 設定（managed-settings.json）中可用
• 無法被使用者或專案設定覆蓋（最高優先順序）
• 在網路/檔案系統操作之前強制執行（被阻止的來源永遠不會執行）
• 對來源規格使用精確匹配（包括 git 來源的 ref、path），除了 hostPattern 和 pathPattern，它們使用正規表達式匹配

白名單行為：

• undefined（預設）：無限制 - 使用者可以新增任何 marketplace
• 空陣列 []：完全鎖定 - 使用者無法新增任何新 marketplaces
• 來源清單：使用者只能新增完全符合的 marketplaces

所有支援的來源類型：

白名單支援多種 marketplace 來源類型。大多數來源使用精確匹配，而 hostPattern 和 pathPattern 分別使用正規表達式匹配 marketplace 主機和檔案系統路徑。

1. GitHub 儲存庫：

{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }

欄位：repo（必需）、ref（選用：分支/標籤/SHA）、path（選用：子目錄）

2. Git 儲存庫：

{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }

欄位：url（必需）、ref（選用：分支/標籤/SHA）、path（選用：子目錄）

3. 基於 URL 的 marketplaces：

{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }

欄位：url（必需）、headers（選用：用於驗證存取的 HTTP 標頭）

4. NPM 套件：

{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }

欄位：package（必需，支援範圍套件）

5. 檔案路徑：

{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }

欄位：path（必需：marketplace.json 檔案的絕對路徑）

6. 目錄路徑：

{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }

欄位：path（必需：包含 .claude-plugin/marketplace.json 的目錄的絕對路徑）

7. 主機模式匹配：

{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }

欄位：hostPattern（必需：用於符合 marketplace 主機的正規表達式模式）

當您想允許來自特定主機的所有 marketplaces 而不列舉每個儲存庫時，請使用主機模式匹配。這對於具有內部 GitHub Enterprise 或 GitLab 伺服器的組織很有用，開發人員可以在其中建立自己的 marketplaces。

按來源類型的主機提取：

• github：始終符合 github.com
• git：從 URL 提取主機名稱（支援 HTTPS 和 SSH 格式）
• url：從 URL 提取主機名稱
• npm、file、directory：不支援主機模式匹配

8. 路徑模式匹配：

{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
{ "source": "pathPattern", "pathPattern": ".*" }

欄位：pathPattern（必需：與 file 和 directory 來源的 path 欄位相符的正規表達式模式）

使用路徑模式匹配來允許檔案系統型 marketplaces 與網路來源的 hostPattern 限制並行。設定 ".*" 以允許所有本機路徑，或設定更窄的模式以限制到特定目錄。

設定範例：

範例：僅允許特定 marketplaces：

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "source": "npm",
      "package": "@acme-corp/compliance-plugins"
    }
  ]
}

範例 - 停用所有 marketplace 新增：

{
  "strictKnownMarketplaces": []
}

範例：允許來自內部 git 伺服器的所有 marketplaces：

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

精確匹配要求：

Marketplace 來源必須完全符合才能允許使用者的新增。對於基於 git 的來源（github 和 git），這包括所有選用欄位：

• repo 或 url 必須完全符合
• ref 欄位必須完全符合（或兩者都未定義）
• path 欄位必須完全符合（或兩者都未定義）

不符合的來源範例：

// 這些是不同的來源：
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }

// 這些也不同：
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }

與 extraKnownMarketplaces 的比較：

格式差異：

strictKnownMarketplaces 使用直接來源物件：

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ]
}

extraKnownMarketplaces 需要命名 marketplaces：

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

同時使用兩者：

strictKnownMarketplaces 是政策閘門：它控制使用者可能新增的內容，但不註冊任何 marketplaces。若要同時限制和為所有使用者預先註冊 marketplace，請在 managed-settings.json 中設定兩者：

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ],
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

僅設定 strictKnownMarketplaces 時，使用者仍可透過 /plugin marketplace add 手動新增允許的 marketplace，但它不會自動提供。

重要注意事項：

• 限制在任何網路請求或檔案系統操作之前檢查
• 被阻止時，使用者會看到清晰的錯誤訊息，指示來源被 managed 政策阻止
• 限制在 marketplace 新增和 plugin 安裝、更新、重新整理和自動更新時強制執行。在設定政策之前新增的 marketplace 一旦其來源不再符合白名單，就無法用於安裝或更新 plugins
• Managed 設定具有最高優先順序，無法被覆蓋

請參閱 Managed marketplace 限制以了解面向使用者的文件。

管理 plugins

使用 /plugin 命令以互動方式管理 plugins：

• 瀏覽 marketplaces 中的可用 plugins
• 安裝/解除安裝 plugins
• 啟用/停用 plugins
• 檢視 plugin 詳細資訊（提供的 skills、agents、hooks）
• 新增/移除 marketplaces

在 plugins 文件中深入了解 plugin 系統。

環境變數

環境變數可讓您控制 Claude Code 行為，而無需編輯設定檔案。任何變數也可以在 settings.json 中的 env 金鑰下設定，以將其應用於每個工作階段或推出到您的團隊。

請參閱環境變數參考以了解完整清單。

Claude 可用的工具

Claude Code 可以存取一組工具，用於讀取、編輯、搜尋、執行命令和協調 subagents。工具名稱是您在權限規則和 hook 匹配器中使用的確切字串。

請參閱工具參考以了解完整清單和 Bash 工具行為詳細資訊。

另請參閱

• Permissions：權限系統、規則語法、工具特定模式和 managed 政策
• Authentication：設定使用者對 Claude Code 的存取
• Debug your configuration：診斷為什麼設定、hook 或 MCP server 未生效
• Troubleshoot installation and login：安裝、authentication 和平台問題