AI Coding Hub

上手

Claude Code 教學：從第一次工作階段到實際上工

在專案資料夾輸入 `claude` 就開始了。接著用中文或英文把要做的事寫清楚，代理程式會讀檔案、提出修改、執行指令。順利與不順利的差別，幾乎都不在模型狀態，而在兩件事：你知不知道它到底讀了什麼（用 `/context` 看），以及你有沒有把「每次都要重講一遍」的前提寫進 `CLAUDE.md`。這篇就照這兩件事的順序走。

繁體中文 · 最後查證日: 2026-09-05 · 英文完整版： English

第一次工作階段拿來「診斷」，不要拿來寫功能

第一次不要直接叫它加功能。原因不是保守，而是效率：先丟一個唯讀任務，例如「說明 src/api/handlers/ 在做什麼」，從回答的細緻程度就能看出它對這個專案的理解有沒有偏掉。如果理解已經偏了，讓它動手寫也只會把同樣的偏差寫進程式碼。

cd ~/projects/my-app
claude

# 工作階段內最常用的兩個指令
/context   # 實際被載入上下文的東西
/memory    # 列出 CLAUDE.md 相關檔案並開啟編輯

`/context` 看起來平淡，但「指令沒被遵守」的第一層排查幾乎都靠它。如果 Memory files 那一欄裡沒有你的 `CLAUDE.md`，那就是根本沒被讀到——這時候再怎麼改寫指令都沒用，問題出在放的位置。

用中文下指令可以嗎

可以。但有個實務技巧：檔名、函式名稱、錯誤訊息請保留原文貼上。「登入相關的錯誤」遠不如 `AuthTokenExpiredError` 有用，因為後者是代理程式可以直接拿去搜尋的線索。這跟語言無關，是「能不能定位到目標」的問題。

上下文就是帳單

一次工作階段的費用由消耗的 token 決定。讀很多檔案的執行會撐大輸入，長時間的代理任務會撐大輸出。也就是說，「每一輪都重讀整個儲存庫」這種用法不會讓品質變好，只會讓帳單變大。真正有效的三個做法，依序是：把指令講具體、用路徑限定的規則、把工作拆給子代理。

為什麼有些指令就是不被遵守

官方文件寫得很直白：CLAUDE.md 的內容是以「系統提示之後的使用者訊息」形式送進去的，不是被強制執行的設定。所以它不保證嚴格遵守。像「每次 commit 前一定要跑某個檢查」這種時機必須確定的事，應該寫成 hook——hook 是在生命週期固定點執行的 shell 指令，不受模型判斷影響。

第一週的學習順序

  1. 第 1–2 天：只丟唯讀任務，每次都用 `/context` 看它讀了什麼。
  2. 第 3 天：用 `/init` 產生專案 `CLAUDE.md` 的草稿，再自己把不符事實的地方改掉。若檔案已存在，`/init` 會提出改進建議而不是覆寫。
  3. 第 4–5 天：交出小型修改，並且一定要讀 diff。過程中每次心裡想「這個我剛剛才講過」，就把它補進 CLAUDE.md。
  4. 第 6 天：遇到需要外部工具的任務時，只接一個 MCP 伺服器，不要一次接很多。
  5. 第 7 天：把重複發生的工作（例如程式碼審查）抽成子代理。

費用大致怎麼算

依 claude.com/pricing 的標示，Pro 月付 20 美元、年付則平均每月 17 美元（一次付 200 美元）；Max 自每月 100 美元起；Team 標準席年付每席每月 20 美元、月付 25 美元（2026-09-05 查證）。Pro、Max、Team 三種方案都明確寫著包含 Claude Code。若改用 API 金鑰，則是按 token 計費，沒有上限也沒有固定月費。

常見問題

Claude Code 可以用中文下指令嗎？
可以，用繁體中文或英文的行為沒有差別。但建議檔名、函式名稱與錯誤訊息保留原文貼上，因為代理程式會拿這些字串去搜尋定位；翻成中文反而會讓它找不到對應的程式碼。
開始用之前要先準備什麼？
專案根目錄的 CLAUDE.md。把建置指令、測試指令、資料夾結構、命名慣例這些「每次都要重講」的前提寫進去。可以先用 `/init` 產生草稿；若檔案已存在，`/init` 會提出改進建議而不覆寫。是否真的載入，用 `/context` 的 Memory files 確認。
指令沒有被照做怎麼辦？
先執行 `/context`，看 Memory files 裡有沒有那個檔案。沒有就是沒被讀到，屬於放置位置的問題。有被讀到的話，把指令寫得更具體（「縮排用兩個半形空格」勝過「把程式碼排版整齊」）。多個 CLAUDE.md 互相矛盾時，模型可能會任選其一。
要怎麼壓低費用？
把上下文縮小最有效。具體來說：明確指定要處理的檔案；用 .claude/rules/ 的 paths 設定，讓規則只在讀到相符檔案時才載入；把工作拆給子代理，避免整段對話一路帶著走。官方也建議單一 CLAUDE.md 控制在 200 行以內，那同時是一條成本建議。

資料來源

延伸閱讀