2026 Claude Code 完整教學：讓 AI 工程師住在你的 Terminal 裡
Claude Code 是 Anthropic 官方推出的 CLI 開發工具，能直接操作你的程式碼、跑測試、修 bug、發 PR。本文從安裝到進階技巧完整教學，讓你的開發效率翻倍。
最後更新：2026-04-20
目錄
1. Claude Code 是什麼？和 Cursor、Copilot 差在哪
Claude Code 是 Anthropic 官方推出的命令列 AI 開發工具。它不是 IDE，也不是自動補全外掛，而是一個住在你 Terminal 裡的「AI 工程師」——你給它指令，它自己讀 codebase、改檔案、跑測試、commit、甚至開 PR。
-
GitHub Copilot（補全）
IDE 外掛，根據你正在打的字補全程式碼。以行為單位輔助
-
Cursor（AI 編輯器）
IDE 本身就整合 AI，有 chat、composer、agent 等模式。以檔案為單位協作
-
Claude Code（Agent CLI）
命令列工具，可跨越整個 repo 做複雜任務。以任務為單位執行
-
Devin / OpenHands（自主 Agent）
完全自主的雲端工程師。門檻高、成本高、但能做大任務
小提示
- Claude Code 最大優勢是「你在哪都能用」——任何 Terminal、任何 IDE、甚至 SSH 到伺服器都行
- 不是要取代 Cursor，而是互補。很多人兩個都用
2. 安裝與設定：5 分鐘上手
Claude Code 支援 macOS、Linux、Windows（WSL）。安裝步驟：
-
前置：Node.js 18+
Claude Code 用 Node 實作，先確認 node -v >= 18
-
全域安裝
npm install -g @anthropic-ai/claude-code
-
登入
在專案目錄跑 claude，首次會導引你到瀏覽器登入 Claude 帳號
-
確認訂閱
需要 Claude Pro（US$20/月）或 Max（US$100 / US$200/月）。API 計費模式也支援
-
開始對話
登入後直接打指令，例如「幫我看看這個 repo 的架構」或「修掉 TypeScript 錯誤」
小提示
- 第一次用建議選空專案或複製一份，熟悉它的行為再用在正式專案
- 可設定 ~/.claude/CLAUDE.md 做全域偏好，每個專案也能有獨立的 CLAUDE.md
3. CLAUDE.md：最重要的設定檔
CLAUDE.md 是 Claude Code 最強大的功能之一。它是放在專案根目錄的 Markdown 檔，Claude 每次啟動會自動讀取，作為專案脈絡：
-
專案規則
寫 code 風格、命名慣例、不要 hardcode 什麼、安全規則
-
架構說明
目錄結構、資料流、核心 class 介紹。讓新 Claude session 快速上手
-
常用指令
跑測試、部署、開發伺服器的指令。Claude 會知道遇到問題時該跑什麼
-
已知陷阱
「這個 migration 不要動」「那個 API 限流」等踩過的雷
-
團隊約定
commit 訊息格式、PR 模板、review 流程
小提示
- 別把 CLAUDE.md 寫成論文。重點條列式、具體、可執行的規則最有效
- 把「最常忘記的事」寫進去。Claude 不會忘，但人會
4. 核心能力：Claude Code 能做什麼
以下全部可以用自然語言指令完成：
| 類型 | 範例指令 | Claude 會做什麼 |
|---|---|---|
| 探索 | 「這個 repo 在做什麼？」 | 讀 README、package.json、主要檔案，產出摘要 |
| 實作 | 「加一個使用者登入功能」 | 規劃檔案、新增路由、寫測試、更新文件 |
| 除錯 | 「登入失敗，幫我找原因」 | 跑測試、讀 log、定位 bug、提出修法 |
| 重構 | 「把 UserService 拆成三個 class」 | 分析依賴、逐步重構、確保測試仍通過 |
| 測試 | 「為 api/users 加測試到 80% 覆蓋率」 | 讀懂邏輯、寫 unit/integration test |
| Git 操作 | 「幫我開 PR 說明這次改動」 | 跑 git diff、產生訊息、呼叫 gh 開 PR |
| 文件 | 「更新 README 反映新 API」 | 讀 code、改 Markdown、保持一致 |
5. Slash Commands 與 Skills：客製你的工作流
Claude Code 支援兩種擴展機制：
-
Slash Commands（/指令）
放在 .claude/commands/xxx.md 的檔案會變成 /xxx 指令。例如 /test、/deploy、/review 都可自訂
-
Skills（技能）
更結構化的封裝，放在 .claude/skills/xxx/。包含 prompt、腳本、資料，可做複雜工作流
-
Hooks（鉤子）
在特定事件觸發（PreCommit、PostTool 等）執行腳本。例如 commit 前自動跑 lint
-
MCP Servers
Model Context Protocol，讓 Claude 接入外部工具：GitHub、Notion、資料庫、瀏覽器等
-
Sub-Agents
用 Agent 工具啟動專門 agent 做特定任務，避免塞爆主 context
小提示
- 常做的事一定要做成 Slash Command。例如 /sprint、/review、/deploy
- 團隊版本請把 .claude/ 放進 git，全員共用指令和規則
6. 進階技巧一：Context 管理
Claude Code 的上限是 context window。用得好、省 token、任務成功率高：
-
先讓它探索再動手
別急著叫它實作。先「你先看一下 repo 再告訴我怎麼做」，讓它建立脈絡
-
指定檔案範圍
「只看 apps/calculator/」比「幫我改計算功能」更聚焦、更省 context
-
用 Agent 隔離
研究、搜尋類任務丟給 sub-agent，研究結果 100 字摘要回來，避免大量檔案內容塞進主 context
-
/compact 清理
長 session 可用 /compact 壓縮歷史，保留重點、釋放空間
-
切段落開新 session
大任務完成後開新 session，效能比硬撐一整天好很多
7. 進階技巧二：Prompt Caching 省錢
Claude Code 預設啟用 prompt caching，但你可以更主動利用：
-
什麼會被快取
CLAUDE.md、系統 prompt、工具定義會自動快取。快取命中 9 折
-
批次跑相似任務
連續處理同性質檔案（例如把 10 個 .md 翻成英文），快取命中率超高
-
別頻繁改 CLAUDE.md
CLAUDE.md 改動會 invalidate 快取。規則不要一直調整
-
大檔案先讀再批次
讀一次大檔後連續問多個問題，比每次重讀便宜很多
小提示
- Max 方案月費 US$100-200 看似貴，但重度用戶通常比 API 便宜，還不用管配額
- 團隊買 Team 方案可共享預算和成員管理
8. 進階技巧三：讓 Claude 自主完成大任務
想讓 Claude Code 做「一次搞定整個 feature」的大任務，有以下訣竅：
-
給一個明確目標
「完成使用者訂閱功能：可建立、升級、取消」比「幫我做訂閱」明確十倍
-
提供驗收標準
「寫完要通過 pytest」「覆蓋率 80%」「不能改 DB schema」——AI 才知道何時算完成
-
搭配 plan mode
先用 --plan 或要求它「先列計畫再執行」，你 review 過計畫再放它跑
-
設定安全界線
CLAUDE.md 寫「不要 git push --force」「不要動 production config」
-
拆成 milestone
「做到可以執行的 MVP 就停、讓我 review」比讓它一口氣做完所有功能更可控
注意事項
Claude Code 有實際執行指令的能力（rm、git push、發送 API）。重要專案務必用 git 管控、定期 commit、不要給 sudo 或生產環境權限。
9. 團隊導入：從個人到全公司
個人爽用，團隊要 scale 需要紀律：
-
共用 .claude/ 目錄
把 CLAUDE.md、commands、skills 放進 repo，全員同步的規則與工具
-
訓練分享
辦一場 30 分鐘內訓，示範常用指令、分享自訂 command、解答疑問
-
程式碼所有權
AI 寫的 code 仍是人的責任。Review 規則不變，誰提交誰負責
-
安全規範
.env、keys、客戶資料不能被讀進 context。用 .claudeignore（如有）或 CLAUDE.md 明令
-
成本控管
Enterprise 方案有使用量儀表板，可見每人、每專案花費，找出過度使用者
10. 常見問題 Q&A
使用 Claude Code 最常被問到：
| 問題 | 答案 |
|---|---|
| 需要多少月費？ | Pro US$20 可試、Max US$100-200 適合重度用戶、API 計費適合偶爾用 |
| 資料會被拿去訓練嗎？ | Anthropic 預設不訓練，企業方案更有合約保障 |
| 可以在公司 repo 用嗎？ | 先看公司 AI 政策。多數大公司有白名單，Claude Code 多在清單內 |
| Windows 支援？ | 透過 WSL。原生 Windows 支援陸續推進中 |
| 真的能取代工程師？ | 不會。它能放大資深工程師的產能 2-3 倍，但缺乏判斷的新手用它反而危險 |
| 和 Cursor 哪個好？ | 不互斥。Cursor 適合在 IDE 內流暢寫 code，Claude Code 適合跨 repo 大任務 |
| 沒網路能用嗎？ | 不行，需要連線 Anthropic API |
注意事項
AI 寫的程式仍可能有 bug、安全漏洞、版權疑慮。正式專案應 Code Review、跑完整測試、做安全掃描後才 merge。
重點整理
- 1 Claude Code 是 Anthropic 官方 CLI 開發工具，能跨 repo 執行複雜任務：探索、實作、除錯、重構、測試、開 PR
- 2 CLAUDE.md 是最重要的設定檔：寫規則、架構、常用指令，Claude 每次啟動自動讀取
- 3 擴展機制四大類：Slash Commands、Skills、Hooks、MCP Servers，打造團隊共用的 AI 工作流
- 4 進階技巧：Context 管理（先探索再動手）、Prompt Caching 省錢、大任務先 Plan 後 Execute
- 5 團隊導入要點：共用 .claude/ 目錄、資安規範、code review 不變、成本追蹤
相關連結
相關懶人包
2026 AI Agent 完整指南：從 Copilot 到自主代理人，讓 AI 替你完成整個任務
AI Agent 是 2026 最火紅的技術趨勢。本文帶你搞懂 Agent 和 Copilot 的差別、主流框架、實用場景與風險控管，讓你真正把 AI 從助手變成同事。
2026 AI 工具實用指南：提升工作與生活效率的 10 大應用
從 ChatGPT 到 Claude，全面解析 2026 年最實用的 AI 工具，幫你省時間、提效率、做更好的決策
2026 AI 工具推薦：10 個提升工作效率的免費 AI 神器
精選 2026 年最實用的 10 款免費 AI 工具，涵蓋 ChatGPT、Gemini、Claude、Midjourney 等，從文字寫作到圖片生成，全面提升工作效率的完整指南
一般聲明
本站提供之資訊僅供參考，不保證其完整性與正確性。使用者應自行判斷資訊之適用性。