有效管理成本 - Claude Code Docs

Claude Code 按 API token 消耗量計費。如需訂閱計畫定價（Pro、Max、Team、Enterprise），請參閱 claude.com/pricing。每位開發人員的成本差異很大，取決於模型選擇、程式碼庫大小和使用模式，例如執行多個執行個體或自動化。在企業部署中，平均成本約為每位開發人員每個活躍日

13，每位開發人員每月

150-250，90% 的使用者成本保持在每個活躍日 $30 以下。若要估計您自己團隊的支出，請從小型試點群組開始，並使用下面的追蹤工具建立基準，然後再進行更廣泛的推出。本頁涵蓋如何追蹤您的成本、管理團隊成本和減少 token 使用。

追蹤您的成本

使用 `/usage` 命令

/usage 中的 Session 區塊顯示 API token 使用情況，適用於 API 使用者。Claude Max 和 Pro 訂閱者的使用情況已包含在其訂閱中，因此工作階段成本數字與計費無關。訂閱者會在同一畫面上看到計畫使用情況列、活動統計資訊和使用情況明細。

/usage 頂部的 Session 區塊顯示您目前工作階段的詳細 token 使用統計資訊。美元數字是根據 token 計數在本地計算的估計值，可能與您的實際帳單不同。如需權威計費資訊，請參閱 Claude Console 中的「使用情況」頁面。

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

在 Pro、Max、Team 或 Enterprise 計畫上，/usage 還會顯示計入您計畫限制的內容明細。它將最近的使用情況歸因於 skills、subagents、plugins 和個別 MCP servers，每個都顯示為總數的百分比。按 d 或 w 在過去 24 小時和過去 7 天之間切換。這些數字是近似值，根據此機器上的本地工作階段歷史記錄計算，因此不包括來自其他裝置或 claude.ai 的使用情況。在 VS Code 擴充功能中，相同的明細會出現在「帳戶與使用情況」對話框中，並提供「日」和「週」切換。需要 Claude Code v2.1.174 或更新版本。

管理團隊成本

使用 Claude API 時，您可以在 Claude Code 工作區支出上設定工作區支出限制。管理員可以在 Console 中檢視成本和使用情況報告。在 Pro 和 Max 方案上，您可以使用 /usage-credits 命令在使用額度上設定每月支出限制。如果您在仍有使用額度可用時達到該限制，Claude Code 會提示您提高或移除該限制，以便您可以繼續使用而無需離開 CLI。變更限制需要帳戶的計費存取權限。

當您首次使用 Claude Console 帳戶驗證 Claude Code 時，系統會自動為您建立一個名為「Claude Code」的工作區。此工作區為您的組織中所有 Claude Code 使用情況提供集中式成本追蹤和管理。您無法為此工作區建立 API 金鑰；它專門用於 Claude Code 驗證和使用。對於具有自訂速率限制的組織，此工作區中的 Claude Code 流量計入您的組織整體 API 速率限制。您可以在 Claude Console 的此工作區的「限制」頁面上設定工作區速率限制，以限制 Claude Code 的份額並保護其他生產工作負載。

在 Bedrock、Vertex 和 Foundry 上，Claude Code 不會從您的雲端傳送指標。自託管的 Claude apps gateway 提供每位使用者的使用情況歸因、包含 token 計數的 OTLP 指標，以及這些提供者上的每位使用者支出限制。透過不同 LLM gateway 路由 Claude Code 的組織可以改為在 gateway 追蹤支出，因為它會看到每個請求。

速率限制建議

為團隊設定 Claude Code 時，請根據您的組織規模考慮這些每位使用者的 Token Per Minute (TPM) 和 Request Per Minute (RPM) 建議：

團隊規模	每位使用者 TPM	每位使用者 RPM
1-5 位使用者	200k-300k	5-7
5-20 位使用者	100k-150k	2.5-3.5
20-50 位使用者	50k-75k	1.25-1.75
50-100 位使用者	25k-35k	0.62-0.87
100-500 位使用者	15k-20k	0.37-0.47
500+ 位使用者	10k-15k	0.25-0.35

例如，如果您有 200 位使用者，您可能會為每位使用者請求 20k TPM，或總共 400 萬 TPM (200*20,000 = 400 萬)。隨著團隊規模增長，每位使用者的 TPM 會減少，因為在較大的組織中，傾向於較少的使用者同時使用 Claude Code。這些速率限制適用於組織層級，而不是每個個別使用者，這意味著當其他人未主動使用該服務時，個別使用者可以暫時消耗超過其計算份額的資源。

如果您預期會出現異常高的並行使用情況（例如與大型群組進行的即時培訓課程），您可能需要更高的每位使用者 TPM 配置。

Agent 團隊 token 成本

Agent 團隊會產生多個 Claude Code 執行個體，每個都有自己的上下文視窗。Token 使用量會隨著活躍隊友數量和每個隊友執行時間的長短而擴展。為了保持 agent 團隊成本可控：

為隊友使用 Sonnet。它為協調任務平衡了功能和成本。
保持團隊規模小。每位隊友執行自己的上下文視窗，因此 token 使用量大致與團隊規模成正比。
保持產生提示的焦點。隊友會自動載入 CLAUDE.md、MCP 伺服器和 skills，但產生提示中的所有內容都會從一開始就新增到其上下文中。
工作完成時清理團隊。活躍的隊友即使閒置也會繼續消耗 token。
Agent 團隊預設為停用。在您的settings.json或環境中設定 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 以啟用它們。請參閱啟用 agent 團隊。

減少 token 使用

Token 成本隨上下文大小而擴展：Claude 處理的上下文越多，您使用的 token 就越多。Claude Code 透過 prompt caching（減少重複內容（如系統提示）的成本）和 auto-compact（在接近上下文限制時總結對話歷史記錄）自動優化成本。以下策略可幫助您保持上下文較小並降低每條訊息的成本。

主動管理上下文

使用 /usage 檢查您目前的 token 使用情況，或設定您的狀態行以持續顯示它。

在任務之間清除：切換到不相關的工作時，使用 /clear 重新開始。過時的上下文會在後續的每條訊息上浪費 token。在清除之前使用 /rename 以便稍後輕鬆找到工作階段，然後使用 /resume 返回到它。
新增自訂壓縮指示：/compact Focus on code samples and API usage 告訴 Claude 在總結期間要保留什麼。

您也可以在 CLAUDE.md 中自訂壓縮行為：

# Compact instructions

When you are using compact, please focus on test output and code changes

選擇正確的模型

Sonnet 能很好地處理大多數編碼任務，成本低於 Opus。為複雜的架構決策或多步驟推理保留 Opus。使用 /model 在工作階段中途切換模型，或在 /config 中設定預設值。對於簡單的 subagent 任務，在您的 subagent 設定中指定 model: haiku。

減少 MCP 伺服器開銷

MCP 工具定義預設為延遲，因此只有工具名稱進入上下文，直到 Claude 使用特定工具。執行 /context 以查看消耗空間的內容。

在可用時偏好 CLI 工具：gh、aws、gcloud 和 sentry-cli 等工具比 MCP 伺服器更具上下文效率，因為它們不會新增任何每個工具的列表。Claude 可以直接執行 CLI 命令。
停用未使用的伺服器：執行 /mcp 以查看已設定的伺服器，並停用任何您未主動使用的伺服器。

為型別化語言安裝程式碼智慧外掛

程式碼智慧外掛為 Claude 提供精確的符號導航，而不是基於文字的搜尋，在探索不熟悉的程式碼時減少不必要的檔案讀取。單一「前往定義」呼叫取代了可能需要的 grep 後跟讀取多個候選檔案。已安裝的語言伺服器也會在編輯後自動報告型別錯誤，因此 Claude 無需執行編譯器即可捕捉錯誤。

將處理卸載到 hooks 和 skills

自訂 hooks可以在 Claude 看到資料之前對其進行預處理。Claude 不是讀取 10,000 行日誌檔案來尋找錯誤，hook 可以 grep ERROR 並僅返回匹配的行，將上下文從數萬個 token 減少到數百個。 skill可以為 Claude 提供領域知識，因此它不必進行探索。例如，「codebase-overview」skill 可以描述您的專案架構、關鍵目錄和命名慣例。當 Claude 呼叫該 skill 時，它會立即獲得此上下文，而不是花費 token 讀取多個檔案來理解結構。例如，此 PreToolUse hook 篩選測試輸出以僅顯示失敗：

settings.json
filter-test-output.sh

將此新增到您的 settings.json以在每個 Bash 命令之前執行 hook：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}

hook 呼叫此指令碼，該指令碼檢查命令是否為測試執行器並修改它以僅顯示失敗：

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
  echo "{}"
fi

將指示從 CLAUDE.md 移至 skills

您的 CLAUDE.md檔案在工作階段開始時載入到上下文中。如果它包含特定工作流程的詳細指示（例如 PR 審查或資料庫遷移），即使您在進行不相關的工作時，這些 token 也會存在。Skills僅在呼叫時按需載入，因此將專門指示移至 skills 可以保持您的基本上下文較小。目標是透過僅包含必要內容來將 CLAUDE.md 保持在 200 行以下。

調整延伸思考

延伸思考預設為啟用，因為它可以顯著改善複雜規劃和推理任務的效能。思考 token 會作為輸出 token 計費，預設預算可能是每個請求數萬個 token，取決於模型。對於不需要深度推理的較簡單任務，您可以透過在 /effort 中降低努力等級或在 /model 中降低、在 /config 中停用思考，或在具有固定思考預算的模型上，透過 MAX_THINKING_TOKENS=8000 降低預算來降低成本。自適應推理模型會忽略非零預算，因此請改用努力等級。Fable 5 上無法停用思考，它始終使用延伸思考。

將詳細操作委派給 subagents

執行測試、擷取文件或處理日誌檔案可能會消耗大量上下文。將這些委派給 subagents，以便詳細輸出保留在 subagent 的上下文中，而只有摘要返回到您的主要對話。

管理 agent 團隊成本

當隊友在 plan mode 中執行時，Agent 團隊使用的 token 大約是標準工作階段的 7 倍，因為每位隊友維護自己的上下文視窗並作為單獨的 Claude 執行個體執行。保持團隊任務小且自成一體，以限制每位隊友的 token 使用。有關詳細資訊，請參閱 agent 團隊。

撰寫具體提示

模糊的請求（例如「改進此程式碼庫」）會觸發廣泛掃描。具體的請求（例如「在 auth.ts 中的登入函式中新增輸入驗證」）讓 Claude 能夠以最少的檔案讀取高效地工作。

有效處理複雜任務

對於較長或更複雜的工作，這些習慣有助於避免因走錯方向而浪費的 token：

對複雜任務使用 plan mode：按 Shift+Tab 進入 plan mode，然後再進行實施。Claude 探索程式碼庫並提出一個方法供您批准，防止當初始方向錯誤時進行昂貴的返工。
及早糾正方向：如果 Claude 開始朝著錯誤的方向前進，按 Escape 立即停止。使用 /rewind 或雙擊 Escape 將對話和程式碼恢復到先前的 checkpoint。
提供驗證目標：在您的提示中包含測試案例、貼上螢幕截圖或定義預期輸出。當 Claude 可以驗證自己的工作時，它會在您需要請求修復之前捕捉問題。
增量測試：寫一個檔案、測試它，然後繼續。這會在問題便宜時及早捕捉問題。

背景 token 使用

Claude Code 即使在閒置時也會為某些背景功能使用 token：

對話總結：為 claude --resume 功能總結先前對話的背景工作
命令處理：某些命令（例如 /usage）可能會產生檢查狀態的請求

這些背景程序即使沒有主動互動也會消耗少量 token（通常每個工作階段不到 $0.04）。

瞭解 Claude Code 行為的變化

Claude Code 定期接收可能改變功能工作方式的更新，包括成本報告。執行 claude --version 以檢查您目前的版本。如有具體計費問題，請透過您的Console 帳戶聯絡 Anthropic 支援。

​追蹤您的成本

​使用 /usage 命令

​管理團隊成本

​速率限制建議

​Agent 團隊 token 成本

​減少 token 使用

​主動管理上下文

​選擇正確的模型

​減少 MCP 伺服器開銷

​為型別化語言安裝程式碼智慧外掛

​將處理卸載到 hooks 和 skills

​將指示從 CLAUDE.md 移至 skills

​調整延伸思考

​將詳細操作委派給 subagents

​管理 agent 團隊成本

​撰寫具體提示

​有效處理複雜任務

​背景 token 使用

​瞭解 Claude Code 行為的變化

追蹤您的成本

使用 `/usage` 命令

管理團隊成本

速率限制建議

Agent 團隊 token 成本

減少 token 使用

主動管理上下文

選擇正確的模型

減少 MCP 伺服器開銷

為型別化語言安裝程式碼智慧外掛

將處理卸載到 hooks 和 skills

將指示從 CLAUDE.md 移至 skills

調整延伸思考

將詳細操作委派給 subagents

管理 agent 團隊成本

撰寫具體提示

有效處理複雜任務

背景 token 使用

瞭解 Claude Code 行為的變化