Claude Code 入門到精通：2026 保姆級教學（含省錢設定）

很多人第一次打開 Claude Code，只把它當成“終端機裡的 Claude”。這會浪費它最有價值的能力：Claude Code 不是用來陪你聊天的，它是可以進入本地專案、閱讀程式碼、修改檔案、執行命令、解釋變更的 AI Coding Agent。

如果你只是偶爾問幾句程式碼問題，網頁版 Claude 或 ChatGPT 也夠。但如果你每天都要修 bug、寫測試、做 code review、改腳本、維護多個客戶專案，那麼 Claude Code 的正確用法就不是“能不能用”，而是：怎麼安全地用、怎麼穩定地用、怎麼把成本控制住。

這篇教學從 0 開始，帶你完成 2026 年 Claude Code 的完整工作流：安裝、登入、專案內使用、常見任務提示詞、進階 review 流程，以及如何透過 LowCostAI 這類統一 AI API Gateway 管理 Claude Code 的 API 成本，讓它更適合個人開發者、工作室和小團隊長期使用。

Claude Code 到底是什麼
安裝 Claude Code
第一次啟動：Claude 登入還是 API Key
第一個真實專案：讓 Claude Code 先讀再改
5 個最常用的 Claude Code 工作流
進階用法：把 Claude Code 當成有邊界的工程師
省錢設定：API Key 與 Gateway 化管理
用 LowCostAI 管理 Claude Code 成本
常見錯誤與排查
FAQ

Claude Code 到底是什麼

Claude Code 是 Anthropic 面向軟體專案推出的 agentic coding 工具。它執行在你的開發環境裡，可以讀取目前專案目錄裡的檔案，理解程式碼結構，修改程式碼，並執行測試、建置、lint、腳本等命令。

它和普通聊天工具最大的差別是：

Claude Chat：你把程式碼複製給它，它給你建議。
Claude Code：它進入你的專案目錄，自己看檔案、改檔案、跑命令。

這意味著 Claude Code 更適合處理“有上下文”的工程任務，例如：

閱讀陌生專案並總結結構
定位啟動失敗或建置失敗原因
修復一個具體 bug
為已有模組補測試
重構某個檔案而不改變外部行為
review 目前 git diff
更新 README、遷移說明、發布日誌

但這也意味著你要給它清晰邊界。Claude Code 可以很快，但不能盲信。最好的使用方式不是“讓它自動接管整個專案”，而是把任務拆小：先閱讀、再計畫、後執行，最後驗證。

核心原則：read first, plan second, edit third, verify last。

安裝 Claude Code

最常見的安裝方式是透過 npm：

npm install -g @anthropic-ai/claude-code

安裝完成後檢查版本：

claude --version

進入任意專案目錄啟動：

cd your-project
claude

如果能進入 Claude Code 的互動介面，說明安裝完成。

為什麼建議從終端機工作流開始？因為終端機會讓專案邊界更明確：你在哪個目錄里啟動 Claude Code，它就圍繞哪個專案工作。對新手來說，這比一開始就接入複雜 IDE 外掛更容易理解，也更容易控制風險。

第一次啟動：Claude 登入還是 API Key

Claude Code 常見有兩種使用方式：Claude 帳號登入，以及 API Key / Gateway化設定。

方式一：Claude 帳號登入

第一次執行：

claude

然後跟随登入流程完成授权。

這種方式適合剛開始體驗 Claude Code 的使用者。你不需要理解 Base URL、模型 ID、API Key、Gateway 設定，登入後就能直接使用。

適合：

個人開發者快速體驗
已經經常使用 Claude 的使用者
不需要團隊帳單和專案級統計的場景
簡單本地專案和学习專案

缺點也很明顯：如果你是小團隊、外包工作室或諮詢團隊，很难按專案、成员、客戶分别統計用量，也不方便設定 Key 級額度和預算歸因。

方式二：API Key 或 Gateway化設定

如果你想把 Claude Code 接到 Claude API，或者接到 LowCostAI 這樣的 API Gateway，可以使用 Key-based routing。

臨時測試可以這樣：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
claude

如果使用Gateway，具體環境變數和 endpoint 設定請以 Claude Code 目前支援项和Gateway後台說明為准。關鍵點不是死记某個命令，而是建立統一入口：Key、模型、用量、額度和帳單都能管理。

API Key / Gateway化方式更適合：

高頻使用 Claude Code 的開發者
需要控制成本的小團隊
外包工作室和客戶專案
需要按專案、成员、客戶拆分用量的團隊
需要額度、日誌、帳單和 usage reporting 的場景

第一個真實專案：讓 Claude Code 先讀再改

新手最容易犯的錯誤是，一進專案就對 Claude Code 说：

帮我优化這個專案。

這句话太寬了。Claude Code 不知道“优化”指效能、結構、命名、型別、安全、依賴、建置速度還是 UX，很容易做出一堆你並不想要的修改。

更穩的第一步是讓它唯讀分析：

請閱讀目前專案，輸出：
1. 技術棧
2. 主要目錄結構
3. 啟動命令
4. 測試命令
5. 最重要的業務模組
不要修改任何檔案。

當你確認它理解專案後，再讓它做診斷：

請檢查目前專案最可能导致建置失敗或啟動失敗的問題。
先輸出診斷和修復計畫，不要修改程式碼。

最後才允许它執行：

按剛才的計畫修復，只修改必要檔案。
完成後執行相關測試，並總結 git diff。

這個“三步法”非常重要：

先讀專案
再給計畫
最後修改和驗證

它能顯著降低 AI 亂改程式碼的機率，也讓你更容易 review 最终 diff。

5 個最常用的 Claude Code 工作流

1. 專案導覽

接手新專案時，可以讓 Claude Code 生成專案說明：

請閱讀目前專案，生成一份面向新開發者的專案導覽，包括技術棧、目錄結構、啟動方式、測試方式、核心模組和常見風險。不要修改程式碼。

如果結果不錯，再讓它寫入檔案：

請把上面的專案導覽整理為 PROJECT_OVERVIEW.md。

這個工作流適合接手舊專案、外包專案、客戶專案，也適合把一個人的隱性知識沉澱成團隊檔案。

2. 修復啟動失敗

專案跑不起來時，不要直接讓它“修好”，先定位：

這個專案啟動失敗。請檢查 package.json、設定檔案和錯誤日誌，定位原因。先給診斷，不要修改檔案。

確認診斷後：

按你的診斷修復問題，然後執行啟動命令驗證。

這樣可以避免 Claude Code 在根因不清楚時亂改依賴、設定或入口檔案。

3. 生成測試

寫測試是 Claude Code 性价比最高的任務之一：

請為 src/utils/price.ts 添加單元測試，覆蓋正常輸入、邊界值和異常輸入。先閱讀既有測試风格，不要引入新的測試框架。

关键是告诉它“保持既有风格”。否則它可能會引入專案里根本沒用過的新測試框架，导致維護成本更高。

4. 小範圍重構

適合 Claude Code 的重構應該邊界清晰：

請重構 src/api/user.ts，目標是減少重複程式碼和提升可讀性。不要改變公開函式簽名，不要修改無關檔案。完成後執行相關測試。

不要讓它“一次性重構整個專案”。AI agent 最適合做小步、可驗證、可回滚的修改。

5. 本地 Code Review

提交前可以讓 Claude Code review 目前 diff：

請 review 目前 git diff，重點檢查：
1. 潛在 bug
2. 型別問題
3. 安全風險
4. 效能問題
5. 是否缺少測試
不要修改程式碼，只輸出可執行建議。

這一步特别適合個人開發者。你沒有同事帮你 review 時，Claude Code 至少能提前拦下一部分低級錯誤。

進階用法：把 Claude Code 當成有邊界的工程師

Claude Code 不是“全自動程式設計師”，更像一個執行力很强但需要邊界的 junior engineer。你給它的任務越清晰，它的產出越穩定。

複雜任務建議使用這種提示詞：

我要新增一個 API Key 用量統計頁面。請先閱讀專案結構，然後輸出实現計畫：
1. 需要修改哪些檔案
2. 新增哪些元件
3. 資料從哪里來
4. 風險点是什么
5. 如何測試
先不要修改程式碼。

等計畫合理後再執行：

計畫可以。請按階段实現。每完成一個階段說明改动，並執行對應檢查。

如果涉及高風險模組，例如支付、認證、權限、資料庫遷移，要明確禁止範圍：

不要修改資料庫 schema，不要修改鉴权邏輯，不要執行 git commit。完成後只執行測試並總結 diff。

一個成熟的 Claude Code 工作流通常是：

Claude Code 讀專案
Claude Code 給計畫
人確認邊界
Claude Code 修改程式碼
Claude Code 跑測試
人檢查 git diff
人提交 commit

注意最後一步：不要讓 AI 自動替你提交关键程式碼。提交是責任邊界，最好由人完成。

省錢設定：API Key 與 Gateway 化管理

當你每天只用 Claude Code 幾次時，預設登入方式就夠了。但當你開始高頻使用它做測試、review、檔案和腳本時，成本會变成一個真實問題。

這時可以考虑用 API Key 或 Gateway化方式管理 Claude Code 的調用入口。

最簡單的臨時方式：

export ANTHROPIC_API_KEY="YOUR_API_KEY"
claude

如果你使用 LowCostAI 這類統一入口，建議在後台為 Claude Code 单獨建立 Key，並明確用途，例如：

claude-code-personal-dev
claude-code-team-review
claude-code-client-a
claude-code-ci-docs

這樣你可以知道：

哪個專案最耗钱
哪個客戶的 AI 成本最高
哪個自動化任務異常消耗
哪些模型適合降級
哪些任務必须保留高品質模型

省錢的关键不是“永远用最便宜的模型”，而是按任務分層。

適合低成本模型的任務：

解釋日誌
生成簡單測試
寫腳手架程式碼
總結目錄結構
生成 README 初稿
批次改文案

適合高品質模型的任務：

安全相關程式碼
權限和支付邏輯
資料庫遷移
大型重構
架構设计
最终 code review

這才是 AI Coding 的長期省錢方式：低風險任務降成本，高風險任務保质量。

用 LowCostAI 管理 Claude Code 成本

LowCostAI 的定位不是“只换一個便宜接口”，而是給團隊、工作室和開發者一個統一的 AI API 接入與用量管理入口。

對 Claude Code 使用者來說，真正有價值的是這几件事：

統一接入 Claude、OpenAI、Gemini 等模型
支援 Claude Code、Codex、Cursor、Gemini CLI 等 AI Coding 工具
為不同成员、專案或客戶建立獨立 Key
按 Key 查看用量和帳單
設定額度，避免单個任務失控
用透明口徑展示模型價格、匯率和平台倍率

對個人開發者，它能讓你知道自己每個月 AI Coding 花了多少钱。對小團隊，它能把 AI 成本從“黑盒支出”变成可管理的研发基礎設施。

常見錯誤與排查

一次性讓 Claude Code 改太多

不要寫：

帮我优化整個專案。

改成：

只分析 src/api 目錄的重複程式碼，輸出重構建議，不要修改檔案。

AI Coding 的穩定性來自小步快跑，而不是一次梭哈。

目前終端機沒有載入 Key

檢查：

echo $ANTHROPIC_API_KEY

如果輸出為空，說明目前 shell 沒有載入環境變數。重新 export，或執行：

source ~/.zshrc

讓 AI 改了設定却沒有驗證

任何涉及依賴、建置、路由、認證、支付的修改，都必须要求 Claude Code 執行驗證命令：

完成後請執行 npm test 和 npm run build，並把結果貼出來。

如果驗證失敗，不要急着继续擴大修改範圍。先讓它解釋失敗原因，再做最小修復。

把敏感 Key 寫進專案

不要把 API Key 寫進倉庫裡的 .env.example、README、測試檔案或 prompt 記錄裡。真正的 Key 應該只存在於本機環境變數、金鑰管理服務或 Gateway後台。

模型选择不匹配任務風險

不要用低成本模型處理支付、權限、資料遷移、安全策略等高風險任務。成本節省應該建立在任務分層上，而不是犧牲關鍵路徑质量。

FAQ

Claude Code 適合完全不會程式設計的人吗？

適合学习和做小工具，但不適合完全不 review 地交付生產程式碼。Claude Code 能解釋程式碼、生成样例、辅助排错，但你仍然需要判断它的修改是否合理。

Claude 登入和 API Key 哪個更好？

新手用 Claude 登入最簡單。高頻使用者、小團隊和工作室更適合 API Key 或 Gateway化設定，尤其適合接入 LowCostAI 這類統一 Gateway，方便管理 Key、額度和帳單。

Claude Code 能透過 LowCostAI 使用吗？

可以，前提是你的 Claude Code 設定方式和 LowCostAI 後台提供的接口能力匹配。通常你需要關注 API Key、支援模型、用量統計、額度和帳單口徑。

怎麼防止 Claude Code 亂改程式碼？

讓它先唯讀分析，再輸出計畫；明確限制修改範圍；要求它執行測試；最後你自己檢查 git diff。不要給它过于宽泛的任務。

最推薦的 Claude Code 省錢策略是什么？

按任務分層。低風險任務用低成本模型，高風險任務用高品質模型；同時透過 LowCostAI 給不同專案和客戶分 Key、設額度、查用量。

下一步

如果你還沒用過 Claude Code，建議先從一個非核心專案開始：讓它讀專案、補測試、review diff。等你熟悉工作流後，再把它接入 LowCostAI，給不同專案設定獨立 Key 和額度。

對於個人開發者，Claude Code 能節省大量重複勞動。對於小團隊和工作室，Claude Code + LowCostAI 的組合更像一套可管理的 AI Coding 基礎設施：統一入口、成本可查、額度可控、模型可切換。

你可以從這裡開始：

參考資料：