---
title: "Claude Code 是什麼"
description: "Claude Code 不是聊天框，而是能讀專案、改檔案、跑命令、驗證結果的智慧體式程式設計工具。先理解它進入工程現場的工作方式，再開始安裝。"
canonical: "https://xiangyugongzuoliu.com/tag/claude-code"
verifiedAt: "2026-05-08"
---

Claude Code 的關鍵不是“Claude 會寫程式碼”，而是“Claude 進入了你的工程現場”。它能看到專案檔案、執行命令、修改程式碼、根據結果繼續判斷，這才是它和普通聊天式 AI 的分界線。——Aaron

> [!NOTE]
> **這一章用 10 分鐘換什麼**：官方概覽頁（overview）先回答三個問題：Claude Code 是什麼、可以從哪些入口使用、適合推進哪些開發任務。本篇把它重寫成中文新手路徑：先建立正確心智模型，再進入安裝和登入。

## 1. 先別把它當“程式碼聊天框”

很多人第一次理解 Claude Code，會把它放進熟悉的框架裡：

```text
ChatGPT / Claude.ai 能回答代码问题
Claude Code 也能回答代码问题
所以 Claude Code = 更懂代码的聊天框
```

這個理解會害你用得很淺。

聊天框的典型工作方式是：你複製程式碼、貼上錯誤、等待回答、自己回到專案裡改。AI 只是一個在專案外面的顧問。

Claude Code 的工作方式不同。官方 [概覽頁（overview）](https://code.claude.com/docs/en/overview) 把它定義為智慧體式程式設計工具（agentic coding tool）：它能讀取程式碼庫、編輯檔案、執行命令，並和你的開發工具整合。換成中文開發者更好理解的話：

> [!IMPORTANT]
> **一句話定義**：Claude Code 是一個進入專案目錄工作的程式設計 Agent（智慧體），不只是回答程式碼問題，而是圍繞專案目標連續讀、想、改、跑、驗證。

這就是第一章要建立的心智模型。

## 2. “進入工程現場”到底意味著什麼

假設你有一個登入 bug。

用普通聊天式 AI，你通常這樣做：

```text
复制报错
复制相关代码
问 AI 为什么错
把答案搬回 IDE
再跑测试
再复制新的报错
```

用 Claude Code，你可以在專案目錄裡啟動：

```bash
cd your-project
claude
```

然後直接說。比如你可以用中文提出一個足夠具體的任務：

```text
过期银行卡用户的结账流程现在有问题。
请检查 src/payments/ 里的支付逻辑，重点看 token refresh（令牌刷新）相关部分。
先写一个能复现问题的失败测试，再修复它。
```

這類提示詞不需要很長，但要同時說明問題現象、排查範圍和驗收方式。

它的工作鏈路會變成：

```mermaid
flowchart TD
    Ask["你描述目標"]
    Read["Claude 讀專案上下文"]
    Plan["推理下一步"]
    Act["改檔案 / 跑命令"]
    Verify["看測試或命令結果"]
    Adjust["繼續修正"]

    Ask --> Read --> Plan --> Act --> Verify --> Adjust
    Adjust --> Read

    style Read fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Act fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Verify fill:#dcfce7,stroke:#22c55e,stroke-width:2px
```

官方 [工作原理頁（How Claude Code works）](https://code.claude.com/docs/en/how-claude-code-works) 把這個過程叫智慧體迴圈（agentic loop）：獲取上下文（gather context）、執行動作（take action）、驗證結果（verify results）。三步不是線性跑一遍，而是會反覆迴圈。

這張圖的重點不是節點名，而是角色分工：

| 環節 | 你要抓住什麼 |
|------|--------------|
| 描述目標 | 給目標、約束和驗收標準，不是逐行指揮 |
| 讀上下文 | 讓 Claude 先理解專案結構、相關檔案和現有約定 |
| 改檔案 / 跑命令 | 行動必須落在專案現場，而不是隻輸出建議 |
| 看結果再修正 | 失敗測試、lint、構建輸出會反過來改變下一步 |

> [!TIP]
> **新手判斷法**：如果你的工作還停留在“複製程式碼給 AI，再手動搬回專案”，你還沒有真正用到 Claude Code 的核心能力。

## 3. 它能訪問什麼

Claude Code 能做事，是因為它有工具。

官方工作原理文件（how-it-works）裡把工具分成幾類：檔案操作、搜尋、執行命令、Web（網頁能力）、程式碼智慧。新手先記這張表：

| 能力 | 它能做什麼 | 你要注意什麼 |
|------|------|------|
| 檔案操作 | 讀檔案、改程式碼、建立檔案、重新命名 | 看 diff，不要讓它碰金鑰 |
| 搜尋 | 按檔名、正則、內容搜尋程式碼庫 | 讓它先探索，再動手 |
| 執行命令 | 跑測試、構建、lint、git、指令碼 | 高影響命令要審 |
| Web / 外部資料 | 查文件、抓網頁、接 MCP | 外部系統要配許可權 |
| 程式碼智慧 | 診斷型別錯誤、跳轉定義、找引用 | 依賴 IDE / LSP / 外掛能力 |

在終端裡執行 `claude` 後，它主要能看到：

- **當前專案**：當前目錄和子目錄裡的檔案。
- **終端環境**：你能跑的構建工具、Git、包管理器、指令碼。
- **Git 狀態**：當前分支、未提交改動、最近提交歷史。
- **`CLAUDE.md`**：專案規則、約定、偏好。
- **Auto memory（自動記憶）**：它在工作中自動儲存的專案經驗。
- **擴充套件能力**：MCP、Skills（技能）、Subagents（子 Agent）、Hooks（鉤子）、外掛等。

> [!WARNING]
> **邊界提醒**：能訪問不等於應該訪問。專案金鑰、生產配置、個人憑據和遠端釋出動作，都應該用 Permissions（許可權）、Hooks（鉤子）、Sandbox（沙箱）或人工審查設邊界。

## 4. 它可以做哪些事

官方概覽頁列了很多用法。不要把它理解成“生成程式碼”，更準確是“推進開發任務”：

- 探索專案：`這個專案是做什麼的？`
- 修 bug：`找出 session 過期時登入失敗的原因並修復`
- 加功能：`給使用者登入檔單加輸入校驗`
- 補測試：`給 auth 模組寫測試，跑測試，並修復失敗用例`
- 整理文件：`更新 README，讓它和當前的安裝/啟動流程一致`
- Git 工作流：`幫我把改動 commit 一下，寫一條描述清楚的 message`
- 批次維護：`修復全專案的 lint 錯誤`
- 程式碼審查：`檢查這幾個改動檔案有沒有安全問題`

第一輪不適合直接交給它的任務也要說清：

- 沒有驗收標準的大範圍重構。
- 需要生產許可權、真實客戶資料或支付操作的任務。
- 你自己還沒想清楚邊界，卻要求它“一次性全自動做完”的任務。

關鍵不是命令寫得多漂亮，而是給出目標、約束和驗收。

弱提示（不要這樣寫）：

```text
修一下。
```

更好的提示：

```text
先读 src/auth 和 tests/auth。
bug 是：已过期的 session 没有跳到登录页。
请先写一个能复现问题的失败测试，再实现修复，然后跑相关测试命令。
不要改数据库 schema。
```

> [!IMPORTANT]
> **第一性原理**：Claude Code 做得好不好，不只取決於模型能力，也取決於你有沒有給它清晰的工程目標和驗證標準。

## 5. 入口不止終端，但終端最完整

官方概覽頁當前列了多個入口：Terminal（終端）、VS Code、Desktop app（桌面應用）、Web（網頁）、JetBrains，也提到 CI/CD、Slack、Chrome、Mobile（移動端）、Remote Control（遠端控制）等整合。

這些入口連線的是同一個 Claude Code 底層能力。差別不在“哪個才是真的 Claude Code”，而在程式碼執行在哪裡、你用什麼介面審查 diff、能不能離開本機繼續任務。

官方還在持續擴充套件跨裝置、定時和外部觸發能力：

- **定時任務三種粒度**：`Routines`（雲端常駐，電腦關機也跑）/ `Desktop scheduled tasks`（本機直訪本地檔案）/ `/loop`（CLI 會話內重複一段提示）。
- **跨裝置會話**：`Remote Control`（手機或瀏覽器接管本地會話）/ `Dispatch`（手機派發任務到桌面應用）/ `claude --teleport`（把 web 或 iOS 長任務拉回終端）/ `/desktop`（終端會話轉到桌面應用做 diff 視覺審查）。
- **外部觸發**：`Channels`（Telegram / Discord / iMessage / 自定義 webhook 推送進會話）/ `GitHub Actions` / `GitLab CI/CD`（PR 評論或 issue 觸發 Claude Code）/ Slack `@Claude`（團隊 chat 轉 PR）。

第一章只建立入口判斷，細節放到平臺章節。

新手先按這張表選：

| 入口 | 適合什麼 | 新手建議 |
|------|------|------|
| Terminal CLI（終端命令列） | 本地專案、完整工具鏈、Git、構建和測試 | 第一優先 |
| VS Code / Cursor | 看 inline diff（行內差異）、引用當前編輯器上下文 | 熟悉 IDE 後再接 |
| JetBrains | IntelliJ、PyCharm、WebStorm 使用者 | JetBrains 專案可用 |
| Desktop app（桌面應用） | 視覺 diff（圖形化差異）、多會話、桌面任務 | 需要圖形審查時用 |
| Web（網頁） | 無本地設定、長任務、雲端儲存庫 | 適合遠端和非同步任務 |
| Mobile / Remote Control（移動端 / 遠端控制） | 離開電腦後繼續看任務 | 不是第一入口 |
| CI/CD / Slack | 自動審查、issue triage（問題分診）、團隊觸發 | 團隊成熟後用 |

> [!TIP]
> **新手路線**：先從終端命令列學會基本迴圈，再把 VS Code、Desktop、Web 當成不同場景下的補充入口。

## 6. 第一輪會話該怎麼開始

官方快速開始頁（quickstart）建議從一個真實專案目錄開始，而不是空目錄。

最小路徑是：

```bash
cd your-project
claude
```

第一次會要求登入。登入後，不要馬上讓它大改程式碼。先問一個探索問題：

```text
这个项目是做什么的？
```

然後問更具體的結構問題：

```text
认证流程是在哪里实现的？
```

再讓它提出計劃：

```text
请给我一个计划：在注册表单上加输入校验。先不要动文件。
```

最後才允許執行：

```text
按计划实施。跑相关测试。提交前先给我看 diff。
```

這條路徑背後的原因很簡單：Claude Code 是 Agent，Agent 會自己探索和行動。你越早讓它理解專案邊界，後面越少返工。

```mermaid
flowchart TD
    Start["進入真實專案目錄"]
    Explore["先問專案是什麼"]
    Locate["定位相關模組"]
    Plan["先要計劃"]
    Execute["批准執行"]
    Verify["執行測試 / 看 diff"]

    Start --> Explore --> Locate --> Plan --> Execute --> Verify

    style Plan fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style Verify fill:#dcfce7,stroke:#22c55e,stroke-width:2px
```

這條最小路徑的價值在於降低誤操作：

| 步驟 | 為什麼不能跳過 |
|------|----------------|
| 進入真實專案目錄 | Claude 需要看到真實檔案和專案規則 |
| 先問專案是什麼 | 先確認它讀到的上下文是否正確 |
| 定位相關模組 | 避免它在無關目錄裡猜測實現 |
| 先要計劃 | 把研究和改程式碼拆開，方便你審方向 |
| 批准執行 | 高影響動作仍然由你決定 |
| 執行測試 / 看 diff | 用結果驗證，而不是隻相信回答 |

## 7. 它不是全自動替你負責

Claude Code 很強，但它不是“交出去就不用管”的按鈕。

官方工作原理頁裡強調，你可以隨時打斷並調整方向（interrupt and steer）。它會自主推進，但仍然響應你的輸入。這個設計很重要：Claude Code 不是替你做最終判斷，而是把機械探索、改動和驗證加速。

你仍然要負責：

- 判斷任務是否該做。
- 審查關鍵 diff。
- 審查許可權彈出視窗和高影響命令。
- 判斷測試是否足夠。
- 確認是否提交、推送、部署。

按動作風險劃分，可以這樣看：

- 搜尋檔案通常可以自動放行，因為它是隻讀操作。
- 改普通原始碼可以給條件信任，因為能看 diff，也能回復。
- 跑測試 / lint 通常可以自動放行，因為風險低且可驗證。
- 改 `.env` / secrets 不應該自動放行，因為涉及憑據。
- `git push` / deploy 應該人工確認，因為會影響遠端狀態。
- 資料庫寫入 / 刪除應該嚴格限制，因為可能不可逆。

> [!CAUTION]
> **不要把“能自動行動”理解成“可以自動負責”**：Claude Code 能跑命令，不代表每個命令都應該自動放行。後面的 [Permissions 章節](/zh-Hant/docs/claude-code/official/01-core-capabilities/permissions) 會專門解決這個邊界。

## 8. 這章和後面章節的關係

這一章只解決一個問題：Claude Code 到底是什麼。

後面的入門篇會逐步落到操作：

- **安裝和更新**：怎麼把 CLI 裝到本機，並保持版本正確。
- **登入與認證**：用訂閱、Console、企業雲或第三方提供商登入。
- **選擇平臺與整合**：CLI、Desktop、IDE、Web、Mobile 怎麼選。

理解篇會繼續補底層概念：

- **上下文**：Claude 一次能看到多少東西。
- **記憶**：跨會話怎麼記住專案習慣。
- **Skills（技能）/ Subagents（子 Agent）/ MCP**：能力怎麼擴充套件。
- **Hooks（鉤子）/ Permissions（許可權）**：自動化和安全邊界怎麼管。

> [!TIP]
> **一句話收束**：先把 Claude Code 當成“在專案現場迴圈工作的 Agent”，再去學安裝、配置和擴充套件。順序反了，就容易把它用成普通聊天框。

## 9. 本章自檢

試著用自己的話回答：

1. Claude Code 和普通聊天式 AI 的核心差別是什麼？對應 §1-§2。
2. 智慧體迴圈（agentic loop）的三步是什麼？為什麼它會迴圈？對應 §2。
3. Claude Code 在終端裡主要能訪問哪幾類上下文？對應 §3。
4. 為什麼新手應該先從終端命令列入口開始，而不是一上來混用所有入口？對應 §5。
5. 哪些動作適合自動放行，哪些動作應該人工確認？對應 §7。

> [!IMPORTANT]
> **過關標準**：你能說清 Claude Code 不是“幫你寫程式碼的聊天框”，而是“帶工具、上下文和許可權邊界的本地程式設計 Agent”。

<details id="glossary">
<summary><b>本篇術語速查表</b></summary>

- **Claude Code**：Claude 程式設計 Agent（智慧體），Anthropic 面向軟體工程現場的智慧體式程式設計工具（agentic coding tool）。
- **Agentic coding tool**：智慧體式程式設計工具，能讀上下文、呼叫工具、採取行動並驗證結果的程式設計工具。
- **Agentic loop**：智慧體迴圈，獲取上下文（gather context）、執行動作（take action）、驗證結果（verify results）反覆推進任務。
- **Terminal CLI**：終端命令列入口，最完整的本地 Claude Code 使用入口。
- **Context**：上下文，當前會話裡 Claude 能看到並用於判斷的資訊。
- **Tool**：工具，Claude 用來讀檔案、搜尋、編輯、執行命令、聯網的能力。
- **`CLAUDE.md`**：專案說明檔案，每次會話開頭載入的專案規則和偏好。
- **Auto memory**：自動記憶，Claude 在工作中儲存的專案經驗和偏好。
- **Permission**：許可權，控制 Claude 能不能執行某類工具呼叫的規則。
- **Checkpoint**：檢查點，檔案改動前的本地快照，用於回退 Claude 的編輯。

</details>

## 官方來源

- [Claude Code overview](https://code.claude.com/docs/en/overview)
- [Quickstart](https://code.claude.com/docs/en/quickstart)
- [How Claude Code works](https://code.claude.com/docs/en/how-claude-code-works)

## 接下來去哪

<Cards>
  <Card href="/zh-Hant/docs/claude-code/official/00-getting-started/install" title="安裝和更新 Claude Code" description="理解產品定位後，下一步是按官方推薦方式安裝 CLI，並知道 native installer、Homebrew、WinGet 的差別。" />
  <Card href="/zh-Hant/docs/claude-code/understanding/01-what-is-claude-code" title="深度理解：Claude Code 是什麼" description="如果想看更完整的心智模型，去理解篇第一章，把 AI 進入專案現場這一點講透。" />
  <Card href="/zh-Hant/docs/claude-code/official/00-getting-started/platforms" title="選擇平臺與整合" description="如果你已經裝好了，直接看 CLI、Desktop、IDE、Web、Mobile 這些入口該怎麼選。" />
</Cards>

如果只記一個判斷：**Claude Code 的起點不是“問 AI 一段程式碼”，而是“讓 Agent 進入專案現場，在你的邊界內完成開發迴圈”。**
