> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 如何運作

> 了解代理迴圈、內建工具，以及 Claude Code 如何與您的專案互動。

Claude Code 是在您的終端機中執行的代理助手。雖然它在編碼方面表現出色，但它可以幫助您從命令列執行的任何操作：撰寫文件、執行建置、搜尋檔案、研究主題等。

本指南涵蓋核心架構、內建功能，以及[有效使用 Claude Code 的提示](#work-effectively-with-claude-code)。如需逐步說明，請參閱[常見工作流程](/docs/zh-TW/common-workflows)。如需擴展功能（如 skills、MCP 和 hooks），請參閱[擴展 Claude Code](/docs/zh-TW/features-overview)。

<h2 id="the-agentic-loop">
  代理迴圈
</h2>

當您給 Claude 一項任務時，它會經歷三個階段：**收集上下文**、**採取行動**和**驗證結果**。這些階段相互融合。Claude 始終使用工具，無論是搜尋檔案以了解您的程式碼、編輯以進行變更，還是執行測試以檢查其工作。

<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agentic-loop.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=4a30fb7ce2815012a9f27c955e2c6bb0" className="dark:hidden" alt="代理迴圈的圖表：您的提示導致 Claude 收集上下文、採取行動、驗證結果，並重複直到任務完成。您可以在任何時刻中斷。" width="720" height="280" data-path="images/agentic-loop.svg" />

<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/agentic-loop-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=75e1d55ed76857a952f9a2dffbab02df" className="hidden dark:block" alt="代理迴圈的圖表：您的提示導致 Claude 收集上下文、採取行動、驗證結果，並重複直到任務完成。您可以在任何時刻中斷。" width="720" height="280" data-path="images/agentic-loop-dark.svg" />

迴圈會根據您的要求進行調整。關於您程式碼庫的問題可能只需要收集上下文。錯誤修復會反覆循環所有三個階段。重構可能涉及廣泛的驗證。Claude 根據從上一步學到的內容決定每一步需要什麼，將數十個操作鏈接在一起，並沿途進行課程修正。

您也是這個迴圈的一部分。您可以在任何時刻中斷以引導 Claude 朝不同方向發展、提供額外上下文，或要求它嘗試不同的方法。Claude 自主工作，但對您的輸入保持回應。

代理迴圈由兩個元件提供動力：[模型](#models)進行推理，[工具](#tools)採取行動。Claude Code 是 Claude 周圍的層，提供工具並管理模型看到的上下文。這個周圍層就是術語代理工具所指的。

<h3 id="models">
  模型
</h3>

Claude Code 使用 Claude 模型來理解您的程式碼並推理任務。Claude 可以讀取任何語言的程式碼、理解元件如何連接，以及找出需要改變什麼來完成您的目標。對於複雜任務，它將工作分解為步驟、執行它們，並根據學到的內容進行調整。

[多個模型](/docs/zh-TW/model-config)可用，具有不同的權衡。Sonnet 可以很好地處理大多數編碼任務。Opus 為複雜的架構決策提供更強的推理能力。在會話期間使用 `/model` 切換，或使用 `claude --model <name>` 開始。

當本指南說「Claude 選擇」或「Claude 決定」時，是模型在進行推理。

<h3 id="tools">
  工具
</h3>

工具是使 Claude Code 成為代理的原因。沒有工具，Claude 只能用文字回應。有了工具，Claude 可以採取行動：讀取您的程式碼、編輯檔案、執行命令、搜尋網路，以及與外部服務互動。每個工具使用都會返回資訊，反饋到迴圈中，告知 Claude 的下一個決定。

內建工具通常分為五個類別，每個類別代表不同類型的代理能力。

| 類別 | Claude 可以做什麼 |
| - | - |
| **檔案操作** | 讀取檔案、編輯程式碼、建立新檔案、重新命名和重新組織 |
| **搜尋** | 按模式查找檔案、使用正規表達式搜尋內容、探索程式碼庫 |
| **執行** | 執行 shell 命令、啟動伺服器、執行測試、使用 git |
| **網路** | 搜尋網路、擷取文件、查詢錯誤訊息 |
| **程式碼智能** | 編輯後查看類型錯誤和警告、跳轉到定義、查找參考（需要[程式碼智能外掛程式](/docs/zh-TW/plugins/code-intelligence)） |

這些是主要功能。Claude 還具有用於生成 subagents、詢問您問題和其他編排任務的工具。請參閱[Claude 可用的工具](/docs/zh-TW/tools-reference)以取得完整清單。

Claude 根據您的提示和沿途學到的內容選擇使用哪些工具。當您說「修復失敗的測試」時，Claude 可能會：

1. 執行測試套件以查看失敗的內容
2. 讀取錯誤輸出
3. 搜尋相關的原始檔案
4. 讀取這些檔案以理解程式碼
5. 編輯檔案以修復問題
6. 再次執行測試以驗證

每個工具使用都會給 Claude 新資訊，告知下一步。這就是代理迴圈的實際運作。

**擴展基本功能：** 內建工具是基礎。您可以使用 [skills](/docs/zh-TW/skills) 擴展 Claude 知道的內容、使用 [MCP](/docs/zh-TW/mcp) 連接到外部服務、使用 [hooks](/docs/zh-TW/hooks) 自動化工作流程，以及將任務卸載給 [subagents](/docs/zh-TW/sub-agents)。這些擴展形成了核心代理迴圈之上的一層。請參閱[擴展 Claude Code](/docs/zh-TW/features-overview) 以獲得有關為您的需求選擇正確擴展的指導。

<h2 id="what-claude-can-access">
  Claude 可以存取什麼
</h2>

當您在目錄中執行 `claude` 時，Claude Code 可以存取：

* **您的專案。** 您目錄和子目錄中的檔案，以及其他地方經您許可的檔案。
* **您的終端機。** 您可以執行的任何命令：建置工具、git、套件管理器、系統公用程式、指令碼。如果您可以從命令列執行，Claude 也可以。
* **您的 git 狀態。** 目前分支、未提交的變更和最近的提交歷史。
* **您的 [CLAUDE.md](/docs/zh-TW/memory)。** 一個 markdown 檔案，您可以在其中儲存專案特定的指示、慣例和 Claude 應該在每個工作階段中知道的上下文。如果您的儲存庫有供其他編碼 agent 使用的 AGENTS.md，Claude [可以讀取該檔案](/docs/zh-TW/memory#agents-md)來取代 CLAUDE.md。
* **[自動記憶](/docs/zh-TW/memory#auto-memory)。** Claude 在您工作時自動儲存的學習內容，例如您的偏好。MEMORY.md 的前 200 行或 25KB（以先到者為準）在每個會話開始時載入。
* **您設定的擴展。** 用於外部服務的 [MCP servers](/docs/zh-TW/mcp)、用於工作流程的 [skills](/docs/zh-TW/skills)、用於委派工作的 [subagents](/docs/zh-TW/sub-agents)，以及用於瀏覽器互動的 [Claude in Chrome](/docs/zh-TW/chrome)。

因為 Claude 看到您的整個專案，它可以跨越它工作。當您要求 Claude「修復身份驗證錯誤」時，它會搜尋相關檔案、讀取多個檔案以理解上下文、跨它們進行協調編輯、執行測試以驗證修復，以及在您要求時提交變更。這與只看到目前檔案的內聯程式碼助手不同。

<h2 id="environments-and-interfaces">
  環境和介面
</h2>

[代理迴圈](#the-agentic-loop)、[工具](#tools)和功能在您使用 Claude Code 的任何地方都是相同的。改變的是程式碼執行的位置以及您與它互動的方式。

<h3 id="execution-environments">
  執行環境
</h3>

Claude Code 在三個環境中執行，每個環境對程式碼執行位置有不同的權衡。

| 環境 | 程式碼執行位置 | 使用案例 |
| - | - | - |
| **本機** | 您的機器 | 預設。完全存取您的檔案、工具和環境 |
| **雲端** | Anthropic 管理的 VM，或[您的組織運營的自託管環境](/docs/zh-TW/self-hosted-environments) | 卸載任務、處理您本機沒有的儲存庫 |
| **遠端控制** | 您的機器，從瀏覽器控制 | 使用網路 UI，同時保持執行和您的檔案在本機 |

<h3 id="interfaces">
  介面
</h3>

您可以透過終端機、[桌面應用程式](/docs/zh-TW/desktop)、[IDE 擴展](/docs/zh-TW/vs-code)、[claude.ai/code](https://claude.ai/code)、[遠端控制](/docs/zh-TW/remote-control)、[Slack](/docs/zh-TW/slack) 和 [CI/CD 管道](/docs/zh-TW/github-actions)存取 Claude Code。介面決定了您如何看到和與 Claude 互動，但底層代理迴圈是相同的。請參閱[在任何地方使用 Claude Code](/docs/zh-TW/overview#use-claude-code-everywhere)以取得完整清單。

<h2 id="work-with-sessions">
  使用會話
</h2>

Claude Code 在您工作時將您的對話儲存在本機為純文字 JSONL 檔案，位於 `~/.claude/projects/` 下，這使得[重新開始](#undo-changes-with-checkpoints)、[恢復和分叉](#resume-or-fork-sessions)會話成為可能。在 Claude 進行程式碼變更之前，它還會快照受影響的檔案，以便您在需要時可以還原。如需路徑、保留期和如何清除此資料，請參閱[`~/.claude` 中的應用程式資料](/docs/zh-TW/claude-directory#application-data)。

**會話是獨立的。** 每個新會話都以新的上下文視窗開始，沒有來自先前會話的對話歷史。Claude 可以使用[自動記憶](/docs/zh-TW/memory#auto-memory)跨會話保留學習內容，您可以在 [CLAUDE.md](/docs/zh-TW/memory) 中新增自己的持久指示。

<h3 id="work-across-branches">
  跨分支工作
</h3>

每個 Claude Code 對話都是綁定到您目前目錄的會話。`/resume` 選擇器預設顯示目前 worktree 中的會話，並具有鍵盤快捷鍵以擴展清單到其他 worktrees 或專案。請參閱[管理會話](/docs/zh-TW/sessions#use-the-session-picker)以取得完整的選擇器快捷鍵清單以及名稱解析的工作方式。

Claude 看到您目前分支的檔案。當您切換分支時，Claude 看到新分支的檔案，但您的對話歷史保持不變。Claude 記得您討論過的內容，即使在切換後也是如此。

由於會話綁定到目錄，您可以使用 [git worktrees](/docs/zh-TW/worktrees) 執行平行 Claude 會話，這會為個別分支建立單獨的目錄。

<h3 id="resume-or-fork-sessions">
  恢復或分叉會話
</h3>

使用 `claude --continue` 或 `claude --resume` 恢復會話會在相同的會話 ID 下重新開啟它，並將新訊息附加到現有對話。使用 `--fork-session` 或 `/branch` 分叉會將歷史複製到新的會話 ID 中，保持原始不變。

<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/session-continuity.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=04ed0984a58e4127e05b3640265241a3" className="dark:hidden" alt="會話連續性圖表：恢復繼續相同的會話，分叉使用新 ID 建立新分支。" width="560" height="280" data-path="images/session-continuity.svg" />

<img src="https://mintcdn.com/claude-code/_xqph1dUOslCOwsj/images/session-continuity-dark.svg?fit=max&auto=format&n=_xqph1dUOslCOwsj&q=85&s=886a384bce8298594e43f124617ea665" className="hidden dark:block" alt="會話連續性圖表：恢復繼續相同的會話，分叉使用新 ID 建立新分支。" width="560" height="280" data-path="images/session-continuity-dark.svg" />

如需恢復旗標、`/resume` 選擇器、命名，以及當相同會話在兩個終端機中開啟時會發生什麼，請參閱[管理會話](/docs/zh-TW/sessions)。

<h3 id="the-context-window">
  上下文視窗
</h3>

Claude 的上下文視窗保存您的對話歷史、檔案內容、命令輸出、[CLAUDE.md](/docs/zh-TW/memory)、[自動記憶](/docs/zh-TW/memory#auto-memory)、載入的 skills 和系統指示。當您工作時，上下文會填滿。Claude 會自動壓縮，但對話早期的指示可能會丟失。將持久規則放在 CLAUDE.md 中，並執行 `/context` 以查看什麼在使用空間。

如需互動式逐步說明，請參閱[探索上下文視窗](/docs/zh-TW/context-window)。

<h4 id="context-claude-code-adds-on-its-own">
  Claude Code 自行新增的上下文
</h4>

如果 Claude 遵循您未撰寫的規則，例如在提交中新增 `Co-Authored-By` 預告片，該規則可能來自[系統提醒](/docs/zh-TW/glossary#system-reminder)。當您工作時，Claude Code 會在您的訊息旁邊將自己的上下文新增到對話中：

* 您的 CLAUDE.md 檔案
* 您的[輸出樣式](/docs/zh-TW/output-styles)的指示
* 當 Claude 之前讀取的檔案在磁碟上變更時的備註
* 提交和拉取請求的歸屬行

要變更或移除歸屬行，請設定 [`attribution`](/docs/zh-TW/settings-reference#attribution)。要移除 Claude Code 的內建提交和拉取請求指示，請將 [`includeGitInstructions`](/docs/zh-TW/settings-reference#includegitinstructions) 設定為 `false`。如需其他開關，請參閱[關閉您的代理程式替換的上下文](/docs/zh-TW/agent-sdk/modifying-system-prompts#turn-off-the-context-your-agent-replaces)。

<h4 id="when-context-fills-up">
  當上下文填滿時
</h4>

Claude Code 在您接近限制時自動管理上下文。它首先清除較舊的工具輸出，然後在需要時總結對話。您的請求和關鍵程式碼片段被保留；對話早期的詳細指示可能會丟失。將持久規則放在 CLAUDE.md 中，而不是依賴對話歷史。

要控制在壓縮期間保留的內容，請在 CLAUDE.md 中新增「Compact Instructions」部分或使用焦點執行 `/compact`（如 `/compact focus on the API changes`）。

如果單個檔案或工具輸出非常大，以至於在每次摘要後上下文立即重新填滿，Claude Code 會在幾次嘗試後停止自動壓縮，並顯示錯誤而不是迴圈。請參閱[自動壓縮停止並出現 thrashing 錯誤](/docs/zh-TW/troubleshooting#auto-compaction-stops-with-a-thrashing-error)以取得恢復步驟。

執行 `/context` 以查看什麼在使用空間。MCP 工具定義預設會延遲，並透過[工具搜尋](/docs/zh-TW/mcp#scale-with-mcp-tool-search)按需載入，因此只有工具名稱和伺服器指示會消耗上下文，直到 Claude 使用特定工具。

<h4 id="manage-context-with-skills-and-subagents">
  使用 skills 和 subagents 管理上下文
</h4>

除了壓縮，您可以使用其他功能來控制什麼載入到上下文中。

[Skills](/docs/zh-TW/skills) 按需載入。Claude 在會話開始時看到 skill 描述，但完整內容只在使用 skill 時載入。對於您手動呼叫的 skills，設定 `disable-model-invocation: true` 以將描述保留在上下文之外，直到您需要它們。對於您沒有撰寫的 skills，使用 [`skillOverrides`](/docs/zh-TW/skills#override-skill-visibility-from-settings) 從設定中執行相同操作。

[Subagents](/docs/zh-TW/sub-agents) 在自己的上下文視窗中工作。Subagent 會以新的開始，除非它是[分叉](/docs/zh-TW/sub-agents#fork-the-current-conversation)，這會以您目前為止的對話副本開始。無論哪種方式，subagent 的工具呼叫都保持在您的上下文之外，Claude 在 subagent 完成時會獲得摘要。

請參閱[上下文成本](/docs/zh-TW/features-overview#understand-context-costs)以了解每個功能的成本，以及[減少令牌使用](/docs/zh-TW/costs#reduce-token-usage)以獲得管理上下文的提示。

<h2 id="stay-safe-with-checkpoints-and-permissions">
  使用檢查點和許可保持安全
</h2>

Claude 有兩個安全機制：檢查點讓您撤銷檔案變更，許可控制 Claude 可以在不詢問的情況下執行的操作。

<h3 id="undo-changes-with-checkpoints">
  使用檢查點撤銷變更
</h3>

**檔案編輯是可逆的。** 在 Claude 編輯檔案之前，它會快照目前內容。如果出現問題，按 `Esc` 兩次以重新開始到先前狀態，或要求 Claude 撤銷。

檢查點與 git 分開，當您繼續對話時仍然可用。它們只涵蓋檔案變更，而復原會[跳過符號連結和硬連結檔案](/docs/zh-TW/checkpointing#symlinked-and-hard-linked-paths-not-restored)。影響遠端系統的操作（資料庫、API、部署）無法檢查點。您可以使用許可模式和許可規則來控制這些。

<h3 id="control-what-claude-can-do">
  控制 Claude 可以做什麼
</h3>

選擇許可模式以設定 Claude 可以在不詢問您的情況下執行的操作。按 `Shift+Tab` 循環通過許可模式：

* **Auto**：分類器在背景中檢查大多數操作，並阻止風險操作而不是詢問您。在 Claude Code v2.1.283 或更新版本中，它是互動式終端和 VS Code 工作階段的[內建起始許可模式](/docs/zh-TW/permission-modes#which-mode-a-session-starts-in)，在較早版本中僅在 Pro、Max 和 Team 方案上
* **Manual**：Claude 在檔案編輯和 shell 命令之前詢問
* **Accept edits**：Claude 編輯檔案並執行常見的檔案系統命令（如 `mkdir` 和 `mv`）而不詢問，仍然詢問其他命令
* **Plan**：Claude 探索並提出計畫而不編輯您的原始檔案

您也可以在 `.claude/settings.json` 中允許特定命令，以便 Claude 不會每次都詢問。這對於受信任的命令（如 `npm test` 或 `git status`）很有用。設定可以從組織範圍的政策範圍到個人偏好。請參閱[許可](/docs/zh-TW/permissions)以取得詳細資訊。

***

<h2 id="work-effectively-with-claude-code">
  有效使用 Claude Code
</h2>

這些提示可幫助您從 Claude Code 獲得更好的結果。如需更多關於特定提示、驗證和規劃的資訊，請參閱[最佳實踐](/docs/zh-TW/best-practices)。

<h3 id="ask-claude-code-for-help">
  向 Claude Code 尋求幫助
</h3>

Claude Code 可以教您如何使用它。提出問題，例如「我如何設定 hooks？」或「構建我的 CLAUDE.md 的最佳方式是什麼？」，Claude 會解釋。

內建命令也會引導您完成設定：

* `/init` 為您的專案產生一個入門 CLAUDE.md
* `/doctor` 執行設定檢查，診斷安裝和配置問題，並可以修復它們

<h3 id="it’s-a-conversation">
  這是一個對話
</h3>

Claude Code 是對話式的。您不需要完美的提示。從您想要的開始，然後細化：

```text theme={null}
修復登入錯誤
```

\[Claude 調查，嘗試一些東西]

```text theme={null}
這不太對。問題在於會話處理。
```

\[Claude 調整方法]

當第一次嘗試不正確時，您不會重新開始。您進行迭代。

<h4 id="interrupt-and-steer">
  中斷和引導
</h4>

您可以在任何時刻重新導向 Claude，無需重新開始。執行以下任一操作：

* **按 `Esc`** 立即停止 Claude。正在執行的工具呼叫被取消，Claude 等待您的下一個指令。如果您有排隊的訊息，Claude Code [會接著發送它們](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works)。
* **輸入更正並按 `Enter`** 而不停止 Claude。訊息在輸入框上方顯示為已排隊。如果 Claude 正在執行工具呼叫，它會在這些呼叫完成後立即讀取訊息，在同一輪內進行調整，然後執行下一步。[在 Claude 工作時排隊訊息](/docs/zh-TW/interactive-mode#queue-messages-while-claude-works)涵蓋何時發送其他排隊項目。

<h3 id="delegate-don’t-dictate">
  委派，不要指示
</h3>

想像委派給一位能力強大的同事。提供上下文和方向，然後相信 Claude 會找出詳細資訊：

```text theme={null}
結帳流程對於具有過期卡的使用者已損壞。
相關程式碼在 src/payments/ 中。您可以調查並修復它嗎？
```

您不需要指定要讀取哪些檔案或執行哪些命令。Claude 會找出來。

<h2 id="what’s-next">
  接下來
</h2>

<CardGroup cols={2}>
  <Card title="使用功能擴展" icon="puzzle-piece" href="/docs/zh-TW/features-overview">
    新增 Skills 和 MCP 連接
  </Card>

  <Card title="常見工作流程" icon="graduation-cap" href="/docs/zh-TW/common-workflows">
    典型任務的逐步指南
  </Card>
</CardGroup>