Claude Code 教學 — 用按量計費金鑰的日常用法：換模型、算花費、管脈絡

Claude Code 的用法可以濃縮成四步：在專案資料夾執行 claude、先跑一次 /init 讓它產生 CLAUDE.md、用中文描述任務並附上檔案路徑、看它提出的修改再決定要不要接受。 它是住在終端機裡的程式助手，會自己讀檔、改檔、跑測試，動手前先徵求你同意。登入 Pro／Max 訂閱或設定一把按量計費的 API 金鑰都能用；走金鑰時每一步都照 token 計費，所以日常用法的重點變成三件事——依任務切換模型、知道一個工作階段花多少、把脈絡保持精簡。

網路上的 Claude Code 教學幾乎都以訂閱登入為前提。這一頁寫給另一種使用者：沒有訂閱、或不想被 5 小時用量窗口卡住，改用按量計費金鑰的人。還沒安裝的話，先看 Claude Code 安裝教學，裝好、連上之後再回來。

第一次上手：四個動作

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

它每次要改檔或執行指令都會先問你。方向不對就按 Esc 讓它停下，再用 /rewind 回到先前的檢查點，程式碼和對話會一起退回。/init 產生的 CLAUDE.md 只是草稿，下面有一節專門講怎麼把它改短。

用 API 金鑰時，一個工作階段怎麼計費

Claude Code 每送出一次請求，都會把系統提示、CLAUDE.md、整段對話和讀過的檔案內容重送一遍，新內容接在最後。沒變的前段會走快取：讀快取按輸入價的 10% 計費，寫入快取按輸入價的 1.25 倍。所以一段工作階段的帳，大頭往往是「重讀舊對話」。

下表借用 Anthropic 官方成本文件示範的一段工作階段——輸入 1,200、輸出 5,300、讀快取 940,000、寫快取 50,000 個 token——換成 Kunavo 的費率，在四個模型上各算一次：

在 Claude Sonnet 5 上，這段帳單約 85% 是快取的讀寫。換句話說，決定花費的是對話拉得多長，而不是你打了幾個字——這也是後面「脈絡衛生」那一節的理由。

要看自己的數字，在 Claude Code 裡執行 /usage（/cost 是它的別名），會列出這四種 token 數。但旁邊那個金額是 Claude Code 用 Anthropic 牌價在本機估算的；走 Kunavo 時，實際扣款以後台的 用量頁為準，那裡有每個模型的 token 數（含快取讀寫）與扣款金額。

依任務切換模型

先在 ~/.claude/settings.json 的 env 區塊把每個別名對應到實際的模型。寫在這個檔案裡，編輯器擴充套件和背景程序也讀得到；不要寫進專案裡會被 commit 的 .claude/settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

設好之後，切換只要一行：

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5

/model 會把選擇存成之後新工作階段的預設；只想這一次換，就執行不帶參數的 /model，在選單裡按 s。ANTHROPIC_DEFAULT_HAIKU_MODEL 另外還管 Claude Code 自己在背景做的摘要與標題，指到最便宜的模型是最划算的一行設定。

在 Kunavo，Claude Opus 5 和 Claude Sonnet 5 目前每 token 同價（$2.00 / $10.00），所以兩者之間怎麼選是看任務，不是看錢；真正拉開帳單差距的是兩端——Claude Haiku 4.5 的單價約是它們的 1/5，Claude Fable 5 則是 3.5 倍。 和官方定價相比：Claude Sonnet 5 與 Anthropic 官方同價，Claude Opus 5 比 Anthropic 官方便宜約 60%，Claude Haiku 4.5 比 Anthropic 官方便宜約 60%，Claude Fable 5 比 Anthropic 官方便宜約 30%。

換模型的時機放在任務之間，不要在任務中間。每個模型的快取是分開的：任務做到一半 /model，下一次請求就得把整段對話以未快取的價錢重讀一遍（快取還有效時，Claude Code 會先請你確認）。先 /clear 再換，重讀的只剩很短的新對話。 思考 token 按輸出價計費，簡單任務可以用 /effort 調低思考程度——同樣在任務開頭設，大多數模型在中途改 effort 也會讓快取失效。

CLAUDE.md：只寫你會一再重複交代的事

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md 在每個工作階段開始時載入，之後每一次請求都帶著它（多半以讀快取的價錢計費）。Anthropic 建議一個檔案控制在 200 行以內——越長越吃脈絡，遵守度也越差。能從程式碼看出來的東西（目錄結構、函式說明）不用寫；只想留給人看的備註可以包在 <!-- --> 裡，送進脈絡前會被拿掉。

還有一個常見的誤會：工作階段中途修改 CLAUDE.md 不會立刻生效，要等到 /clear、/compact 或重新啟動才會讀到新版本。

脈絡衛生：讓每一步都便宜

• 不相關的任務之間用 /clear。它開一段全新的對話，本身不花錢；舊對話之後可以用 /resume 找回。
• 同一個任務拉太長，用 /compact。可以附上要保留的重點，例如 /compact 保留測試輸出和改過的檔案。它要送一次摘要請求，趁快取還有效時做最便宜；離開很久才 compact，摘要請求得把整段歷史以未快取的價錢重讀。
• 走錯方向就 /rewind。退回的是早就快取過的前段，比 compact 更省。
• 金鑰模式下，快取預設只存活 5 分鐘。離開超過 5 分鐘再回來，第一步會把整段前文重新寫入快取（輸入價的 1.25 倍）。要去開會或吃飯前，先 /compact 或 /clear 收尾。
• 用 /context 看是什麼在佔脈絡。走 Kunavo 時這個數字是本機估算——Kunavo 目前沒有提供 /v1/messages/count_tokens，自動壓縮和工作階段本身不受影響。
• 用不到的 MCP 伺服器，在 /mcp 裡關掉。Anthropic 的文件寫明，設了自訂 ANTHROPIC_BASE_URL 就沒有工具搜尋（tool search），MCP 工具定義不會延後載入，而是直接佔進每一次請求。
• 交代任務時附上檔案路徑。「改一下驗證」會讓它到處搜尋、多讀很多檔；「把 src/api/user.ts 的驗證改用 zod」只讀需要的。

想讓它少問幾次「可以執行嗎」，建議只放行讀取與驗證類的指令；一口氣跳過所有確認的旗標，只該在可以整個丟掉的環境裡用，理由在 --dangerously-skip-permissions 的說明（英文）。快取怎麼計費，見快取文件。

花費上限與付款

在 金鑰管理頁替 Claude Code 開一把專用金鑰，設定每月花費上限：到了上限，這把金鑰的請求會回 402，不會繼續扣款，失控的迴圈也就只會燒到上限為止。同一頁還能設 IP 白名單。

帳戶是預付制：最低儲值 $10、餘額不會過期、失敗的請求不收費。台灣可以用國際信用卡（Visa、Mastercard、Amex、JCB、銀聯）或 Apple Pay 儲值，目前沒有街口、LINE Pay 這類本地通道；細節見 Claude Code 費用。

什麼時候訂閱反而划算

每天長時間互動、一個月跑很多步的人，訂閱的固定月費通常比按量計費便宜。判斷只要一次除法：月費 ÷ 每步成本 = 損益平衡的步數；以 Claude Sonnet 5 每步約 $0.062（不計快取）估算，一個月跑得比這個步數少，按量計費較省，沒開工的月份也是 $0。各方案目前的月費與完整算式放在 Claude Code 費用這一頁，這裡不重複。

也要說清楚這條路的取捨：透過 Kunavo 用的是共享容量，沒有專屬配額，也沒有合約 SLA。需要保證配額或 SLA 的團隊，應該直接向 Anthropic 採購。連線設定的完整說明在 Claude Code 整合文件（英文）。

常見問題