---
title: "01 - 什麼是 Claude Code"
type: note
specialty: Programming
tags: [claude-code-cli從0開始使用教學, 01-什麼是claude-code]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 01 - 什麼是 Claude Code

← [[00-Index]] | 下一篇 → [[02-安裝與登入]]

---

## 一句話理解

官方定義：**Claude Code 是一個 agentic coding tool——它讀你的 codebase、改檔案、跑指令、並整合你的開發工具。**

關鍵字是 **agentic**：它不是聊天框，是**會自己動手做多步驟工作的 agent**。你說「幫 auth module 寫測試、跑起來、把失敗的修掉」，它會自己找檔案、寫、執行、看錯誤、再改。

---

## 它跟 ChatGPT / Claude 網頁版差在哪

| | Claude 網頁 / app | Claude Code |
|---|---|---|
| 看得到你的檔案 | 要你貼上去 | ✅ 自己讀，跨多檔 |
| 能改檔案 | ❌ | ✅ |
| 能跑指令 | ❌ | ✅（bash / PowerShell）|
| 能操作 git | ❌ | ✅ commit / branch / PR |
| 記得專案慣例 | 靠你每次講 | ✅ `CLAUDE.md` 自動載入 |
| 適合 | 討論、發想、寫文章 | **推進實際工作** |

跟 [[Programming/Codex/Codex從0開始使用教學/01-什麼是Codex|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` 接手**。這跟 [[Programming/Herdr/Herdr從0開始使用教學/11-遠端與手機工作流|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」的具體做法
- [[Programming/Codex/Codex-CLI從0開始使用教學/01-什麼是Codex-CLI|Codex CLI 01 - 什麼是 Codex CLI]] — 對照組

---

*最後更新：2026-08-04*