Claude Code CLI 可以免費安裝,但執行它並非免費。 Claude Code 採取的每個動作——讀取檔案、提出編輯、執行命令、檢查結果——都是由某人付費的模型呼叫。Anthropic 會為新的 API 帳戶提供少量免費額度供測試,但除此授予額度外沒有免費方案;額度用完後,每次呼叫都會計費。
費用完全取決於你採用兩種付款途徑中的哪一種——claude.ai 訂閱或依權杖計費的 API 金鑰——而兩者適合非常不同的使用模式。不訂閱時執行它最便宜的方式是隨用隨付金鑰:在 Kunavo,每個 Claude 模型都比 Anthropic 的牌價低 30%,只需 $10 儲值,不收月費;設定只需幾個環境變數(如下)。以下是實際計算方式。
哪些免費,哪些不免費
| 元件 | 成本 |
|---|---|
| 安裝 CLI | 免費 |
| VS Code 和 JetBrains 擴充功能 | 免費 |
| 設定、hooks、技能、子代理程式、MCP 伺服器 | 免費 |
| 模型呼叫——也就是實際使用它 | 付費 |
Claude Code 唯一的免費使用方式是訪客通行證。符合資格的 Pro 和 Max 訂閱者可以分享通行證,讓首次使用 Claude 付費方案的人享有為期 7 天的 Pro 試用,其中包含 Claude Code;分享者可透過 /passes 指令找到通行證。通行證數量有限,也可能到期,因此適合用來試用 Claude Code,不能用來持續免費使用(Anthropic 的訪客通行證文章,查閱日期:2026-10-10)。Free 方案本身不包含 Claude Code。
Codex 的情況正好相反:ChatGPT 的 Free 方案在桌面應用程式中包含 Codex,但設有使用限制。兩者的並列比較請見 Codex 免費嗎。
兩種付款方式
| 訂閱方案 | API 金鑰 | |
|---|---|---|
| 計費 | 固定月費(Claude Pro 或 Max) | 依權杖計費,無月費 |
| 額度 | 每個視窗的使用量上限 | 沒有——用多少付多少 |
| 清閒月份 | 仍會收費 | 不收費 |
| 繁忙月份 | 有上限,但你會達到限制 | 隨工作量增加 |
| 最適合 | 每日、可預測的使用量 | 不定期或集中式使用 |
兩者不會疊加,而且目前啟用哪一個很重要:當 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 等認證變數設置時,Claude Code 會使用它而不是已儲存的 claude.ai 登入狀態。你的訂閱會暫停且不被使用,其額度不再適用,使用量改由金鑰計費。取消設置該變數後,Claude Code 會回到訂閱方案。執行 /status 可查看目前使用哪一種。
實際月份的費用
費用取決於代理程式步驟,而非日曆天數。Claude Code 每個步驟都會重新傳送系統提示、對話和新的檔案內容,因此一個步驟比一則聊天訊息更大——通常約為 25,000 個輸入權杖和 1,200 個輸出權杖。按照 Kunavo 在 claude-sonnet-5 上的費率:
| 工作負載 | Kunavo | 按照 Anthropic 定價 |
|---|---|---|
| 一次代理式步驟 | $0.043 | $0.062 |
| 一項 20 步驟的任務 | ~$0.87 | ~$1.24 |
| 繁忙的一天(5 個任務) | ~$4.34 | ~$6.20 |
| 20 個這樣的日子 | ~$87 | ~$124 |
這些是未最佳化的數字——沒有提示快取,所有內容都使用主線模型。輕度或探索性使用每月只需個位數美元;真正昂貴的是持續每日進行代理程式工作,這正是依權杖費率會不斷累積的地方。請在費用計算機中輸入自己的數字,或參閱 Claude Code pricing,了解訂閱層級、完整的每模型費率表,以及兩種途徑之間的損益平衡點。上方的「At Anthropic list」欄位來自 Anthropic 的官方 API 定價,其中列出每個 Claude 模型目前的依權杖牌價,以及同一模型在此處的費用。
執行它最便宜的方式
Claude Code 原生讀取 ANTHROPIC_BASE_URL,因此只要端點提供 Anthropic Messages API,就能對任何端點運作——不需要外掛、修改過的二進位檔或需要維護的代理伺服器。這是降低每權杖費率的支援途徑:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5相同的模型、相同的 CLI,主要模型比牌價低約 30%。保留模型設定行:Claude Code 的內建預設模型及其 opus 和 sonnet 別名會遵循 Anthropic 的最新模型;若 Kunavo 尚未提供其中一個模型,請求會回傳 404。sonnet 別名要求 Sonnet 5.5,而 Kunavo 不提供該模型,因此 /model sonnet、opusplan 的執行階段以及設定為 sonnet 的子代理程式都會回傳 404,除非由 ANTHROPIC_DEFAULT_SONNET_MODEL 固定設定。opus 固定為 Opus 5.5,需要 Claude Code v2.1.280 或更新版本——較舊的安裝請執行 claude update。採用隨用隨付制,最低 $10 儲值,無月費,餘額不會過期——因此安靜的一個月確實不會產生任何費用。完整操作說明請參閱 Claude Code 設定指南。如果您已經使用方案,卻持續遇到方案視窗限制,達到 Claude 限額時會發生什麼事會計算保留方案並為其停止服務的時段新增金鑰是否划算。
真正會影響數字的四個槓桿
- 將背景工作路由至 Haiku。 Claude Code 會自行為摘要和標題發出呼叫。
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5(每 1M 為 $0.70 / $3.50)可將這些工作移至最便宜的模型。一行設定即可永久節省費用——Anthropic Claude API price list列出此處涉及的各模型費率,官方與折扣價格並列。 - 從新的任務開始。 每個步驟都會重新傳送內容,因此長時間執行的工作階段在成本上呈平方增長。新的任務會重新使用較小的內容。
- 讓提示快取發揮作用。 快取輸入會按輸入費率的 10% 計費。在每個步驟都重新傳送穩定前綴的迴圈中,這是可取得的最大單項節省(運作方式)。
- 為金鑰設定上限。 在儀表板中為編輯器配置專用金鑰並設定支出上限。失控的迴圈會受到上限限制,而不是變成意外帳單。
人們常對此誤解的地方
「Claude Code 是開放原始碼,所以免費」
用戶端可免費安裝,與模型呼叫無關。CLI 是便宜的部分;推理才是成本。
「我的 Claude Pro 訂閱涵蓋 API」
不涵蓋。訂閱和 API 金鑰是不同產品,帳務也分開——claude.ai 處理前者,console.anthropic.com 處理後者。Pro 只透過訂閱途徑為 Claude Code 提供資金,不涵蓋透過金鑰的使用。
「如果使用小型模型,一定有免費方案」
只是比較便宜,不是免費。claude-haiku-4-5 每 1M 為 $0.70 / $3.50,雖然只是 Sonnet 的一小部分,仍然會計費。
「閘道表示我可以不用付費給 Anthropic」
你仍在為推理付費——只是費率不同,付款對象不同。改變的是價格和計費模式,而不是它是否需要費用。
常見問題
Claude Code 免費嗎?
Claude Code CLI 可以免費安裝,但執行它並非免費——它採取的每個動作都是必須付費的模型呼叫。你有兩種付費方式:claude.ai 訂閱(Pro 或 Max),該方案額度包含 Claude Code 用量;或使用依權杖計費且無月費的 API 金鑰。沒有可讓 Claude Code 免費呼叫模型的免費方案。
可以不訂閱就使用 Claude Code 嗎?
可以——改用 API 金鑰即可。Claude Code 接受依權杖計費的金鑰,適合不定期使用,因為不寫程式的月份不需支付任何費用。設定金鑰後,任何 claude.ai 訂閱也會暫停使用:在認證變數設置期間,方案額度不再適用,使用量改由該金鑰計費。
Claude Code 每月實際費用是多少?
這取決於你執行多少個代理步驟,而不是使用多少天。一個典型步驟約有 25,000 個輸入 token 和 1,200 個輸出 token;按 Kunavo 費率,在 Claude Sonnet 5 上執行 20 步任務約為 $0.87,而按 Anthropic 牌價約為 $1.24。輕度使用每月花費為個位數美元;高強度每日使用——每天執行五個此類任務、持續 20 天——約為 $87。
Claude Code 有免費試用嗎?
僅限受邀者。符合資格的 Pro 和 Max 訂閱用戶可以送出訪客通行證;從未使用過 Claude 付費方案的人可透過訪客通行證使用 Pro 7 天,其中包含 Claude Code。沒有邀請就無法免費使用:CLI 可免費安裝,但傳送第一個實際提示時,就需要付費方案或有餘額的 API 金鑰。小額按量付費儲值無月費,是嘗試使用時投入成本最低的方式。
執行 Claude Code 最便宜的方式是什麼?
將其指向更便宜的端點,並將背景工作交由小型模型處理。Claude Code 原生支援讀取 ANTHROPIC_BASE_URL,因此使用閘道不需要額外軟體;在 Kunavo 上,相同 Claude 模型的執行成本比 Anthropic 的牌價低約 30%。將 ANTHROPIC_DEFAULT_HAIKU_MODEL 設為 claude-haiku-4-5,就會把 Claude Code 的自動背景呼叫轉移到最便宜的模型,只需一行設定即可永久降低成本。
可以不承諾訂閱就試用 Claude Code 嗎?
可以——隨用隨付金鑰是承諾最低的選項,因為小額儲值不收月費,也不會到期。你也可以先安裝 CLI,探索其設定、技能和命令,再進行任何儲值;只有第一次實際提示需要認證資料。
對我來說,訂閱和 API 哪個比較便宜?
粗略規則是:如果你大多數日子都會用滿訂閱額度,固定費用較划算。如果你是集中使用——有些週使用量很大,有些週完全不用——依權杖計費較划算,因為不使用的週不需付費。請使用 費用計算機 估算自己的損益平衡點。
使用閘道會導致任何功能失效嗎?
程式設計、工具、子代理程式、MCP 和提示快取都能正常運作。Remote Control 和語音聽寫則不行——兩者都需要 claude.ai 身分,且在設定閘道認證資料時無法使用。完整清單請見 設定指南。
如何設定金鑰?
請參閱 取得 Claude Code 的 API 金鑰——其中說明建立金鑰的位置、應放入哪個變數,以及錯誤變數為何會靜默失敗。如果你尚未安裝 CLI,安裝 Claude Code 提供各作業系統的命令。