回到頂部

⌨️ Claude Code 完全指南:終端機裡的 AI 工程師

Claude Code 是 Anthropic 的命令列 AI 程式設計工具,讀你的 codebase、改檔案、跑指令、發 PR。完整解析 Claude Code 的功能、安裝、subagents、hooks、MCP、vs Cursor / Copilot / Devin。

Claude Code 是 2026 年最強的命令列 AI 程式設計助理,由 Anthropic 推出,跑在你的終端機裡。你不用切到瀏覽器、不用複製貼上,在終端機裡一句話就能讓 AI 讀你的 codebase、改檔案、跑指令、發 PR——它不是「補全程式碼的工具」,而是**「住在終端機裡的 AI 工程師」**。

本指南會帶你完整理解 Claude Code 的核心功能、怎麼安裝、如何發揮它的威力,以及跟 Cursor、Copilot、Devin 比起來該怎麼選。

🔑 5 個關鍵重點

  1. Claude Code ≠ 補全工具——它是 agentic CLI,會自己規劃、執行、驗證整個任務
  2. 內建訂閱額度:Claude Pro $20 就包含 Claude Code 基本使用,Max $100 給重度使用者
  3. 2026 殺手級功能:Agent Teams(主 agent + 子 agent 分工)、Plugin System、Hooks、原生 MCP
  4. 跨 IDE 相容:原生 CLI + VS Code / Cursor / Windsurf / JetBrains 擴充
  5. Windows 用戶需先裝 WSL2——Claude Code 不支援原生 Windows

🤔 Claude Code 是什麼?(給完全沒用過的人)

跟傳統 AI 程式設計工具有什麼不同?

如果你用過 GitHub Copilot 或 Cursor,Claude Code 的體驗完全不一樣

  • 🔹 Copilot = AI 幫你自動補全下一行程式碼
  • 🔹 Cursor = Copilot 強化版,在 IDE 裡對 AI 下指令改檔案
  • 🔹 Claude Code = 跑在終端機的 AI 工程師,自主完成整個任務,跨檔案、跨工具、跨流程

一個實際範例

你在終端機裡打:

claude「這個 React 專案的 login page 登入會卡住,幫我找出 bug 並修好」

Claude Code 會自動:

  1. src/pages/login.tsx 和相關元件
  2. API 呼叫路徑,找到後端認證邏輯
  3. 發現 useEffect 有個依賴陣列問題導致無限迴圈
  4. 修正的程式碼,顯示 diff 請你確認
  5. 現有的測試,確認沒破壞其他功能
  6. 建議:要不要順便加一個 regression test?

整個過程你只說了一句話。

💡 一句話理解

Claude Code 就像一個實習工程師住在你的終端機裡——你不用教它用 VSCode、不用教它 git、不用教它怎麼讀程式碼,它本來就會。你只要告訴它「目標是什麼」,它會自己動手做,做到一半會停下來跟你確認。


🚀 安裝教學

方案一:官方安裝腳本(macOS / Linux / WSL2)

這是 2026 年官方推薦的方式(過去的 npm install 方法已被棄用):

# 一行安裝
curl -fsSL https://claude.ai/install.sh | sh

# 啟動
claude

第一次啟動會引導你登入 Claude 帳號(用瀏覽器打開驗證)。登入後就可以直接在終端機裡跟 Claude 對話了。

方案二:Windows 使用者(需先裝 WSL2)

Claude Code 不支援原生 Windows,必須透過 WSL2。

# 在 Windows PowerShell 中
wsl --install
# 重開機後,打開 Ubuntu

然後在 WSL2 的 Ubuntu 裡跑方案一的安裝指令即可。

方案三:IDE 擴充套件

Claude Code 官方提供 IDE 擴充,功能跟 CLI 相同但嵌在 IDE 裡:

  • VS Code / Cursor / Windsurf — 搜尋「Claude Code」安裝擴充
  • JetBrains 全系列(IntelliJ / PyCharm / WebStorm 等)— 在 Plugin Marketplace 安裝

IDE 版和 CLI 版共享同一組設定和額度,你可以混用。

驗證安裝

claude --version    # 看版本
claude doctor       # 檢查環境與權限
claude              # 進入互動模式

進入互動模式後直接用自然語言下指令就行。


🔥 Claude Code 的殺手級功能(2026 年版本)

🤖 Agent Teams:主 agent 指揮子 agent 分工

這是 2026 年最重要的新功能。一個「主 Claude」可以派發子任務給多個「子 Claude」,每個子 agent 有獨立的 context window 平行工作:

主 agent:「重構這個 codebase 的 auth 模組」
 ├── 子 agent 1:讀完 auth 相關的所有檔案,列出依賴關係
 ├── 子 agent 2:分析現有測試,找出覆蓋率缺口
 ├── 子 agent 3:研究業界 auth 最佳實踐
 └── 主 agent:整合三者結果,提出重構計畫 → 等你核准 → 執行

為什麼這很重要? 複雜任務不會把主 agent 的 context 塞爆,而且子任務可以平行跑,速度快很多。

🔌 Plugin System(2026 年推出)

Claude Code 開放了 plugin 架構,你可以:

  • 裝社群寫的 plugin(從 marketplace)
  • 自己寫 plugin(用 Python 或 TypeScript)
  • 透過 plugin 加入:自訂 slash command、hooks、專屬 agent、MCP server 整合

熱門 plugin:Linear 整合、Jira 整合、Figma 設計稿匯入、AWS 資源管理、Terraform apply、database schema migration。

🎣 Hooks:在 Claude 的每個動作前後插入自訂邏輯

Hooks 讓你精細控制 Claude 的行為,是企業級使用不可少的安全機制:

  • pre-edit:編輯檔案前執行(例如:跑 linter 檢查)
  • post-edit:編輯後執行(例如:跑 test、format)
  • pre-commit:commit 前執行
  • pre-bash:跑 shell 指令前執行(例如:禁止 rm -rf
  • on-error:出錯時執行(例如:自動回報到 Slack)

這讓 Claude Code 可以安全地跑在企業的 CI/CD 環境裡。

🧩 原生 MCP 整合

Claude Code 是第一個原生支援 MCP(Model Context Protocol) 的 AI 程式設計工具。這意味著:

  • 安裝任何 MCP server,Claude Code 立刻能用(資料庫查詢、API 呼叫、文件檢索⋯⋯)
  • 你寫的 MCP 工具可以同時給 Claude.ai、Claude Code、OpenClaw、Hermes Agent 用
  • 企業內部系統串接一次,到處可用

→ 深入了解 MCP 看 MCP 協議入門

📋 Slash Commands

Claude Code 內建很多實用的 slash 指令:

  • /plan — 要求 Claude 先規劃再執行
  • /review — 讓 Claude 做 code review
  • /test — 跑測試並自動修錯
  • /commit — 分析 diff 並產生 commit message
  • /pr — 建立 pull request
  • /fast — 切換到 Haiku 模式省錢

你也可以寫自訂 slash command,放在 .claude/commands/ 底下。

🔐 權限系統

Claude Code 預設會先問你再做重要操作:

  • 編輯檔案 → 顯示 diff,問你要不要套用
  • 跑 shell 指令 → 顯示指令,問你要不要執行
  • 刪除檔案 → 強制確認,不能批次同意
  • 存取網路 → 依照設定決定

你可以在 .claude/settings.json 裡設定白名單(永遠允許的操作)和黑名單(永遠禁止的操作)。


💰 怎麼付費?跟 Claude 訂閱的關係

好消息:Claude Pro / Max / Team 訂閱戶直接就有 Claude Code 額度,不用另外付費。

訂閱月費Claude Code 額度
Free$0❌ 不支援
Pro$20✅ 基本使用(中度開發者夠用)
Max $100$100✅ 重度使用,大約 5x Pro
Max $200$200✅ 超重度,約 20x Pro
Team / Enterprise洽詢✅ 企業用量 + 統一管理

多少使用量才夠?

這完全看你的工作模式。實測數據:

  • 輕度使用(每天 10-20 次對話):Pro $20 夠
  • 中度使用(每天 50-100 次 + 偶爾跑 agent teams):可能要 Max $100
  • 重度使用(把 Claude Code 當主要寫 code 方式,每天跑幾小時):Max $200 比較安心

什麼時候該用 API 而非訂閱?

  • 你要把 Claude Code 整合進 CI/CD 系統(按 token 計費反而彈性)
  • 你要開發自己的 Claude Code-like 工具
  • 你要跑的量超出 Max $200 的限制

API 定價詳見 Claude 使用指南


⚔️ Claude Code vs Cursor vs Copilot vs Devin

2026 年 AI 程式設計工具已經分化出幾個不同流派。

工具定位定價最強點弱點
🌟 Claude Code終端機 agentPro $20 起跨 IDE、Agent Teams、原生 MCP、hooks 權限要先熟悉 CLI
CursorAI-first IDE$20 / 月最順的 IDE 體驗、inline edit綁定自家 IDE
GitHub Copilot補全工具$10 / 月IDE 內即時補全、生態最成熟不會規劃多步驟任務
Cognition Devin全自主 agent$500+ / 月從 issue 到 PR 全自動超貴、慢、出錯難修
OpenAI Codex CLIOpenAI 版 CLIChatGPT Plus 起跟 ChatGPT 生態整合功能比 Claude Code 少

該怎麼選?

👨‍💻 專業工程師,每天寫大量程式碼Claude Code + Cursor 搭配

  • 日常補全用 Cursor 的 inline edit
  • 複雜跨檔案任務切到 Claude Code

🆕 新手、想學怎麼用 AI 寫程式Cursor 先上手

  • UI 比較直覺,不用先學 CLI
  • 熟了之後再加 Claude Code

💰 預算極度敏感Copilot $10 / 月

  • 只要補全就夠,不需要 agent 能力

🏢 企業、要全自主 AgentDevin 或自建 Claude Managed Agents

  • Devin 快但貴,Managed Agents 客製化彈性高

🧪 想體驗「AI 自己規劃自己做」Claude Code + Agent Teams

  • 這是最接近 Devin 體驗但只要 Pro 訂閱的方案

💼 Claude Code 的 10 大實用場景

場景Claude Code 怎麼做節省時間
🐛 修 bug讀錯誤、追根源、寫 fix、跑 test70%
🏗️ 開新功能從規格書到實作到測試一條龍60%
🧹 重構 codebaseAgent Teams 分工分析 + 執行50%
📖 讀陌生專案「解釋一下這個專案架構」80%
🔄 遷移框架Vue 2 → 3、Next.js 13 → 14 等65%
✍️ 寫測試看 code → 產出高覆蓋率的測試75%
📝 寫文件自動產 README、API docs、comments85%
🔐 安全稽核掃 OWASP top 10、SQL injection 等70%
🎨 UI 微調看截圖、改 CSS、即時預覽60%
🤖 寫 CI/CDGitHub Actions、Terraform、K8s manifest55%

🛡️ 安全使用建議

Claude Code 有直接執行 shell 指令和改檔案的權限,安全很重要:

  • 🔒 用 git 保護你的工作 —— 重要變更前先 commit,Claude 搞壞了可以 revert
  • 🛡️ 設定 hooks 防呆 —— 在 pre-bash 加上禁止 rm -rf / 之類的指令
  • 🔑 敏感環境變數別直接貼 —— 用 .env 檔且加進 .gitignore,Claude Code 預設不會讀
  • 👀 重要操作總是人工確認 —— 預設就是這樣,別關閉確認步驟
  • 🚫 別讓它跑 production —— 至少在 staging 測過,別直接讓 Claude deploy 到 prod
  • 📝 保留行動日誌 —— Claude Code 會自動記錄,定期檢查

對企業使用者,建議配合 AI 應用安全工程 制定 guideline。


❓ FAQ

Claude Code 跟 Claude.ai 有什麼不同?
  • Claude.ai = 網頁版對話介面,寫文章、讀 PDF、用 Artifacts,通用型
  • Claude Code = 命令列工具,專為軟體開發設計,跑在終端機

兩者用的是同一組模型(Opus / Sonnet / Haiku 4.6),但使用介面、工具和場景不同。如果你的工作主要是寫 code,Claude Code 會讓你的效率翻倍;如果你寫 code 只是偶爾做的事,網頁版夠用。

訂閱 Claude Pro 就同時包含兩者,不用重複付費。

Claude Code 支援繁體中文嗎?

完全支援。 你可以用繁體中文下指令、讓 Claude 產生繁中的 commit message、寫繁中的 README、在程式碼裡加繁中註解。

實測觀察:

  • 繁中指令理解能力跟英文幾乎一樣
  • 產出的文件和 commit message 很自然
  • 程式碼本身建議用英文(變數名、函式名),這是業界慣例
我是新手,完全不會用終端機,能用 Claude Code 嗎?

可以,但建議從 IDE 擴充版開始。 VS Code / Cursor 都有官方 Claude Code 擴充,功能跟 CLI 一樣但介面更友善——你在 IDE 裡按一個鍵就能叫 Claude,不用開終端機。

等你熟悉之後,自然會發現 CLI 版其實更快——這時候再切過去就行。

完全新手的學習路徑

  1. 先學 ChatGPT 完全攻略 熟悉跟 AI 對話
  2. 再看 Claude 完全使用指南 熟悉 Claude 特性
  3. 最後裝 VS Code + Claude Code 擴充,試著讓它幫你改一段 code
  4. 進階:學 CLI 版和 Agent Teams
Claude Code 跟 Cursor 可以一起用嗎?

可以,而且很多工程師就是這樣用的。 兩者不衝突:

  • Cursor 處理日常的 inline edit、tab 補全、快速修改
  • Claude Code 處理複雜的跨檔案任務、agent teams、大規模重構

你甚至可以在 Cursor 裡裝 Claude Code 的 VS Code 擴充,在同一個 IDE 裡同時用兩者。定價上會重複付 $20 + $20,但對專業工程師這錢不太重要——省一小時的時間就賺回來了。

Claude Code 會不會把我的程式碼拿去訓練模型?

不會。 Anthropic 的隱私政策明確說:

  • Claude Pro / Max 訂閱 的 Claude Code 使用預設不會被用於訓練
  • Team / Enterprise 從來不會被用於訓練
  • 除非你主動勾選「允許用我的對話改進 Claude」,才會被用

不過實務上還是要注意:

  • 敏感 codebase(例如未公開的專利演算法)建議用 Team 或 Enterprise 版
  • API Key、密碼、環境變數不要直接貼進對話
  • 企業使用建議看 AI 隱私與資安指南
Agent Teams 功能是什麼?跟一般對話有什麼不同?

Agent Teams 是讓多個 Claude 平行合作的模式。 普通模式下只有一個 Claude 在跟你對話,一步一步做事;Agent Teams 讓主 Claude 派發子任務給多個子 Claude,每個子 agent 獨立跑、獨立 context。

典型使用場景

  • 「重構整個 auth 模組」→ 子 agent 分別處理:讀程式碼、寫新版、遷移測試、更新文件
  • 「研究三個候選方案哪個好」→ 子 agent 分別深入研究每個方案,主 agent 最後整合比較
  • 「巡檢 100 個檔案的安全問題」→ 子 agent 平行掃,主 agent 彙整報告

好處:速度快(平行)、context 不塞爆(各自獨立)、專業分工

壞處:消耗更多 token(每個子 agent 都要錢)

一般用 Pro 就能體驗基礎版,Max 訂閱才能跑大規模的 Agent Teams。

Claude Code 能不能跟 OpenClaw / Hermes Agent 一起用?

可以,而且是互補關係

  • Claude Code 專注在「軟體開發」這個領域的深度,subagent、hooks、IDE 整合做得最好
  • OpenClaw 是通用 agent 作業系統,skill 生態系最廣
  • Hermes Agent 主打自我進化與長期記憶,適合個人助理場景

典型搭配

  • 工作時:在 IDE 裡用 Claude Code 寫程式
  • 下班後:OpenClaw 幫你自動整理 Email、回報社群、處理日常雜事
  • 跨時段累積:Hermes Agent 當你的研究助理,記得你的專案脈絡

三個角色不衝突,都裝都開沒問題。

為什麼 Windows 要裝 WSL2?這很麻煩嗎?

不麻煩,五分鐘搞定。 Claude Code 是基於 Unix-like 環境設計的,很多底層 CLI 工具(ripgrep、git、ffmpeg 等)在原生 Windows 上行為不一致。走 WSL2 可以確保跟 macOS / Linux 使用者的體驗完全一樣。

安裝步驟

# Windows PowerShell(管理員)
wsl --install
# 重開機
# 打開 Start Menu 裡新出現的 Ubuntu
# 在 Ubuntu 裡跑 claude 的安裝指令

從此你的 Windows 就有一個迷你 Linux 環境,不只 Claude Code,所有「應該要在 Unix 裡跑」的開發工具都可以用。這是每個 Windows 工程師都該學的技能。


📌 一句話總結

Claude Code 是目前最強的 AI 程式設計助理,它不只會補全,而是真的會思考 → 規劃 → 執行 → 驗證整個軟體開發任務。對專業工程師來說,它每個月 $20 的投資 ROI 幾乎無限大——省下的時間和減少的 bug 遠超訂閱費用。

給讀者的行動清單

  1. 完全新手 → 先看 ChatGPT 完全攻略Claude 完全使用指南
  2. 有開發經驗,想試試 AI 寫 code → VS Code + Claude Code 擴充 + Pro 訂閱
  3. 重度開發者 → CLI 版 + Max 訂閱 + 學會 Agent Teams
  4. 想理解 agent 本質 → 看 AI Agent 完全指南 搭配這篇一起看

延伸閱讀:

📚 延伸閱讀