01 - 什麼是 Claude Code
一句話理解
官方定義：Claude Code 是一個 agentic coding tool——它讀你的 codebase、改檔案、跑指令、並整合你的開發工具。
關鍵字是 agentic：它不是聊天框，是會自己動手做多步驟工作的 agent。你說「幫 auth module 寫測試、跑起來、把失敗的修掉」，它會自己找檔案、寫、執行、看錯誤、再改。
它跟 ChatGPT / Claude 網頁版差在哪
| Claude 網頁 / app | Claude Code | |
|---|---|---|
| 看得到你的檔案 | 要你貼上去 | ✅ 自己讀，跨多檔 |
| 能改檔案 | ❌ | ✅ |
| 能跑指令 | ❌ | ✅（bash / PowerShell） |
| 能操作 git | ❌ | ✅ commit / branch / PR |
| 記得專案慣例 | 靠你每次講 | ✅ CLAUDE.md 自動載入 |
| 適合 | 討論、發想、寫文章 | 推進實際工作 |
跟 Codex 那份筆記 講的分界一樣：要 think through the work 用聊天介面，要 move the work forward 用 agent。
官方列出的能力（挑跟你有關的）
- 自動處理你一直拖著沒做的雜事：補測試、修 lint、解 merge conflict、更新相依、寫 release notes。
- 蓋功能、修 bug：用自然語言描述，它規劃、跨檔寫 code、驗證。
- git 操作對話化：
claude "commit my changes with a descriptive message"。 - 用 MCP 接外部工具：讀 Google Drive 的文件、更新 Jira、抓 Slack 資料——你的 PubMed MCP 就是走這條。
- 用指令、skill、hook 客製：
CLAUDE.md存專案規矩；skill 打包可重複流程；hook 在特定時機一定執行 shell 指令。 - 多 agent 平行：subagent 分工、background agent 同畫面監看、Agent SDK 自建 agent。
- 管線化 / 腳本化：
tail -200 app.log | claude -p "..."，或在 CI 裡跑。 - 排程：Routines（跑在 Anthropic 的機器上，電腦關機也會跑）、桌面排程任務、
/loop。
一個很重要的觀念：CLI 只是「其中一個介面」
Claude Code 有很多 surface，共用同一個引擎——你的 CLAUDE.md、設定、MCP server 在每個介面都通用：
| 介面 | 特性 |
|---|---|
| Terminal（CLI） | 功能最完整，這份筆記的主題 |
| VS Code / Cursor 擴充 | inline diff、@-mention、plan review |
| JetBrains 外掛 | 需另裝 CLI |
| 桌面 app | 視覺化 diff、多 session 並排、排程任務 |
網頁 claude.ai/code | 免本機設定，長工作丟著跑 |
| 手機 app | 監看和引導進行中的任務 |
| Slack / GitHub Actions / GitLab CI | 團隊與 CI 場景 |
而且 session 可以在介面之間搬：
claude --cloud "..."把任務丟到網頁claude --teleport把網頁 session 拉回本機終端/desktop把目前終端 session 接到桌面 app
💡 對你的實際價值：手機上開一個長任務，回到電腦
claude --teleport接手。這跟 Herdr 的 SSH 巡場 是兩條不同的路，可以並存。
模型
Claude Code 目前可用的模型（用 alias 就好，不用背完整 ID）：
| Alias | 用途 |
|---|---|
opus | 最強，複雜規劃、難題 |
sonnet | 日常主力，速度與能力平衡 |
haiku | 快、便宜，適合簡單重複工作 |
fable | 另一條產品線 |
切換：/model opus、或啟動時 claude --model sonnet、或 Option+P / Alt+P。
還有一個獨立的維度是 effort（思考力度）：/effort low|medium|high|xhigh|max，可用等級依模型而定。
💡 省額度的實務：日常用
sonnet；只有在「要它想清楚架構、或處理很繞的醫學判斷」時才切opus。subagent 也可以個別指定model: haiku做機械性搜尋。
什麼時候「不要」用它
- 你只是想問一個一般知識問題 → 用 Claude 網頁比較快，也不燒 agent 的 context。
- 你要它改的東西沒有版本控制 → 先
git init，不然出事沒得回。 - 你完全不打算 review 它的產出 → 那風險是你的，不是它的。
給初學者的心法
把 Claude Code 當成第一天上工、能力很強但不熟你們家規矩的資深工程師：
- 它很快，但不知道你們的慣例——所以要寫
CLAUDE.md。 - 它會照你說的做，但你說得含糊它就猜——所以要具體。
- 它不會替你負責——所以大改動先看 plan。
最穩的起手式：在一個有 git 的資料夾、開 plan mode、問它「這個專案在做什麼」。
🔗 相關筆記
- 00-Index — 目錄
- 02-安裝與登入 — 下一步
- 05-權限模式與安全 — 「先看 plan」的具體做法
- Codex CLI 01 - 什麼是 Codex CLI — 對照組
最後更新：2026-08-04