Skip to main content
Claude Code 是在您的終端機中執行的代理助手。雖然它在編碼方面表現出色，但它可以幫助您從命令列執行的任何操作：撰寫文件、執行建置、搜尋檔案、研究主題等。 本指南涵蓋核心架構、內建功能，以及有效使用 Claude Code 的提示。如需逐步說明，請參閱常見工作流程。如需擴展功能（如 skills、MCP 和 hooks），請參閱擴展 Claude Code。

​
代理迴圈

當您給 Claude 一項任務時，它會經歷三個階段：收集上下文、採取行動和驗證結果。這些階段相互融合。Claude 始終使用工具，無論是搜尋檔案以了解您的程式碼、編輯以進行變更，還是執行測試以檢查其工作。 代理迴圈的圖表：您的提示導致 Claude 收集上下文、採取行動、驗證結果，並重複直到任務完成。您可以在任何時刻中斷。 代理迴圈的圖表：您的提示導致 Claude 收集上下文、採取行動、驗證結果，並重複直到任務完成。您可以在任何時刻中斷。 迴圈會根據您的要求進行調整。關於您程式碼庫的問題可能只需要收集上下文。錯誤修復會反覆循環所有三個階段。重構可能涉及廣泛的驗證。Claude 根據從上一步學到的內容決定每一步需要什麼，將數十個操作鏈接在一起，並沿途進行課程修正。 您也是這個迴圈的一部分。您可以在任何時刻中斷以引導 Claude 朝不同方向發展、提供額外上下文，或要求它嘗試不同的方法。Claude 自主工作，但對您的輸入保持回應。 代理迴圈由兩個元件提供動力：模型進行推理，工具採取行動。Claude Code 是 Claude 周圍的層，提供工具並管理模型看到的上下文。這個周圍層就是術語代理工具所指的。

​
模型

Claude Code 使用 Claude 模型來理解您的程式碼並推理任務。Claude 可以讀取任何語言的程式碼、理解元件如何連接，以及找出需要改變什麼來完成您的目標。對於複雜任務，它將工作分解為步驟、執行它們，並根據學到的內容進行調整。 多個模型可用，具有不同的權衡。Sonnet 可以很好地處理大多數編碼任務。Opus 為複雜的架構決策提供更強的推理能力。在會話期間使用 /model 切換，或使用 claude --model <name> 開始。 當本指南說「Claude 選擇」或「Claude 決定」時，是模型在進行推理。

​
工具

工具是使 Claude Code 成為代理的原因。沒有工具，Claude 只能用文字回應。有了工具，Claude 可以採取行動：讀取您的程式碼、編輯檔案、執行命令、搜尋網路，以及與外部服務互動。每個工具使用都會返回資訊，反饋到迴圈中，告知 Claude 的下一個決定。 內建工具通常分為五個類別，每個類別代表不同類型的代理能力。 這些是主要功能。Claude 還具有用於生成 subagents、詢問您問題和其他編排任務的工具。請參閱Claude 可用的工具以取得完整清單。 Claude 根據您的提示和沿途學到的內容選擇使用哪些工具。當您說「修復失敗的測試」時，Claude 可能會：
  1. 執行測試套件以查看失敗的內容
  2. 讀取錯誤輸出
  3. 搜尋相關的原始檔案
  4. 讀取這些檔案以理解程式碼
  5. 編輯檔案以修復問題
  6. 再次執行測試以驗證
每個工具使用都會給 Claude 新資訊，告知下一步。這就是代理迴圈的實際運作。 擴展基本功能： 內建工具是基礎。您可以使用 skills 擴展 Claude 知道的內容、使用 MCP 連接到外部服務、使用 hooks 自動化工作流程，以及將任務卸載給 subagents。這些擴展形成了核心代理迴圈之上的一層。請參閱擴展 Claude Code 以獲得有關為您的需求選擇正確擴展的指導。

​
Claude 可以存取什麼

當您在目錄中執行 claude 時，Claude Code 可以存取：
  • 您的專案。 您目錄和子目錄中的檔案，以及其他地方經您許可的檔案。
  • 您的終端機。 您可以執行的任何命令：建置工具、git、套件管理器、系統公用程式、指令碼。如果您可以從命令列執行，Claude 也可以。
  • 您的 git 狀態。 目前分支、未提交的變更和最近的提交歷史。
  • 您的 CLAUDE.md。 一個 markdown 檔案，您可以在其中儲存專案特定的指示、慣例和 Claude 應該在每個會話中知道的上下文。如果您的儲存庫有用於其他編碼代理的 AGENTS.md，Claude 可以自行讀取或與 CLAUDE.md 一起讀取。
  • 自動記憶。 Claude 在您工作時自動儲存的學習內容，例如您的偏好。MEMORY.md 的前 200 行或 25KB（以先到者為準）在每個會話開始時載入。
  • 您設定的擴展。 用於外部服務的 MCP servers、用於工作流程的 skills、用於委派工作的 subagents，以及用於瀏覽器互動的 Claude in Chrome。
因為 Claude 看到您的整個專案，它可以跨越它工作。當您要求 Claude「修復身份驗證錯誤」時，它會搜尋相關檔案、讀取多個檔案以理解上下文、跨它們進行協調編輯、執行測試以驗證修復，以及在您要求時提交變更。這與只看到目前檔案的內聯程式碼助手不同。

​
環境和介面

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

​
執行環境

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

​
介面

您可以透過終端機、桌面應用程式、IDE 擴展、claude.ai/code、遠端控制、Slack 和 CI/CD 管道存取 Claude Code。介面決定了您如何看到和與 Claude 互動，但底層代理迴圈是相同的。請參閱在任何地方使用 Claude Code以取得完整清單。

​
使用會話

Claude Code 在您工作時將您的對話儲存在本機為純文字 JSONL 檔案，位於 ~/.claude/projects/ 下，這使得重新開始、恢復和分叉會話成為可能。在 Claude 進行程式碼變更之前，它還會快照受影響的檔案，以便您在需要時可以還原。如需路徑、保留期和如何清除此資料，請參閱~/.claude 中的應用程式資料。 會話是獨立的。 每個新會話都以新的上下文視窗開始，沒有來自先前會話的對話歷史。Claude 可以使用自動記憶跨會話保留學習內容，您可以在 CLAUDE.md 中新增自己的持久指示。

​
跨分支工作

每個 Claude Code 對話都是綁定到您目前目錄的會話。/resume 選擇器預設顯示目前 worktree 中的會話，並具有鍵盤快捷鍵以擴展清單到其他 worktrees 或專案。請參閱管理會話以取得完整的選擇器快捷鍵清單以及名稱解析的工作方式。 Claude 看到您目前分支的檔案。當您切換分支時，Claude 看到新分支的檔案，但您的對話歷史保持不變。Claude 記得您討論過的內容，即使在切換後也是如此。 由於會話綁定到目錄，您可以使用 git worktrees 執行平行 Claude 會話，這會為個別分支建立單獨的目錄。

​
恢復或分叉會話

使用 claude --continue 或 claude --resume 恢復會話會在相同的會話 ID 下重新開啟它，並將新訊息附加到現有對話。使用 --fork-session 或 /branch 分叉會將歷史複製到新的會話 ID 中，保持原始不變。 會話連續性圖表：恢復繼續相同的會話，分叉使用新 ID 建立新分支。 會話連續性圖表：恢復繼續相同的會話，分叉使用新 ID 建立新分支。 如需恢復旗標、/resume 選擇器、命名，以及當相同會話在兩個終端機中開啟時會發生什麼，請參閱管理會話。

​
上下文視窗

Claude 的上下文視窗保存您的對話歷史、檔案內容、命令輸出、CLAUDE.md、自動記憶、載入的 skills 和系統指示。當您工作時，上下文會填滿。Claude 會自動壓縮，但對話早期的指示可能會丟失。將持久規則放在 CLAUDE.md 中，並執行 /context 以查看什麼在使用空間。 如需互動式逐步說明，請參閱探索上下文視窗。

​
Claude Code 自行新增的上下文

如果 Claude 遵循您未撰寫的規則，例如在提交中新增 Co-Authored-By 預告片，該規則可能來自系統提醒。當您工作時，Claude Code 會在您的訊息旁邊將自己的上下文新增到對話中：
  • 您的 CLAUDE.md 檔案
  • 您的輸出樣式的指示
  • 當 Claude 之前讀取的檔案在磁碟上變更時的備註
  • 提交和拉取請求的歸屬行
要變更或移除歸屬行，請設定 attribution。要移除 Claude Code 的內建提交和拉取請求指示，請將 includeGitInstructions 設定為 false。如需其他開關，請參閱關閉您的代理程式替換的上下文。

​
當上下文填滿時

Claude Code 在您接近限制時自動管理上下文。它首先清除較舊的工具輸出，然後在需要時總結對話。您的請求和關鍵程式碼片段被保留；對話早期的詳細指示可能會丟失。將持久規則放在 CLAUDE.md 中，而不是依賴對話歷史。 要控制在壓縮期間保留的內容，請在 CLAUDE.md 中新增「Compact Instructions」部分或使用焦點執行 /compact（如 /compact focus on the API changes）。 如果單個檔案或工具輸出非常大，以至於在每次摘要後上下文立即重新填滿，Claude Code 會在幾次嘗試後停止自動壓縮，並顯示錯誤而不是迴圈。請參閱自動壓縮停止並出現 thrashing 錯誤以取得恢復步驟。 執行 /context 以查看什麼在使用空間。MCP 工具定義預設會延遲，並透過工具搜尋按需載入，因此只有工具名稱和伺服器指示會消耗上下文，直到 Claude 使用特定工具。

​
使用 skills 和 subagents 管理上下文

除了壓縮，您可以使用其他功能來控制什麼載入到上下文中。 Skills 按需載入。Claude 在會話開始時看到 skill 描述，但完整內容只在使用 skill 時載入。對於您手動呼叫的 skills，設定 disable-model-invocation: true 以將描述保留在上下文之外，直到您需要它們。對於您沒有撰寫的 skills，使用 skillOverrides 從設定中執行相同操作。 Subagents 在自己的上下文視窗中工作。Subagent 會以新的開始，除非它是分叉，這會以您目前為止的對話副本開始。無論哪種方式，subagent 的工具呼叫都保持在您的上下文之外，Claude 在 subagent 完成時會獲得摘要。 請參閱上下文成本以了解每個功能的成本，以及減少令牌使用以獲得管理上下文的提示。

​
使用檢查點和許可保持安全

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

​
使用檢查點撤銷變更

檔案編輯是可逆的。 在 Claude 編輯檔案之前，它會快照目前內容。如果出現問題，按 Esc 兩次以重新開始到先前狀態，或要求 Claude 撤銷。 檢查點與 git 分開，當您繼續對話時仍然可用。它們只涵蓋檔案變更，而復原會跳過符號連結和硬連結檔案。影響遠端系統的操作（資料庫、API、部署）無法檢查點。您可以使用許可模式和許可規則來控制這些。

​
控制 Claude 可以做什麼

選擇許可模式以設定 Claude 可以在不詢問您的情況下執行的操作。按 Shift+Tab 循環通過許可模式：
  • Auto：分類器在背景中檢查大多數操作，並阻止風險操作而不是詢問您。在 Claude Code v2.1.283 或更新版本中，它是互動式終端和 VS Code 工作階段的內建起始許可模式，在較早版本中僅在 Pro、Max 和 Team 方案上
  • Manual：Claude 在檔案編輯和 shell 命令之前詢問
  • Accept edits：Claude 編輯檔案並執行常見的檔案系統命令（如 mkdir 和 mv）而不詢問，仍然詢問其他命令
  • Plan：Claude 探索並提出計畫而不編輯您的原始檔案
您也可以在 .claude/settings.json 中允許特定命令，以便 Claude 不會每次都詢問。這對於受信任的命令（如 npm test 或 git status）很有用。設定可以從組織範圍的政策範圍到個人偏好。請參閱許可以取得詳細資訊。

​
有效使用 Claude Code

這些提示可幫助您從 Claude Code 獲得更好的結果。如需更多關於特定提示、驗證和規劃的資訊，請參閱最佳實踐。

​
向 Claude Code 尋求幫助

Claude Code 可以教您如何使用它。提出問題，例如「我如何設定 hooks？」或「構建我的 CLAUDE.md 的最佳方式是什麼？」，Claude 會解釋。 內建命令也會引導您完成設定：
  • /init 為您的專案產生一個入門 CLAUDE.md
  • /doctor 執行設定檢查，診斷安裝和配置問題，並可以修復它們

​
這是一個對話

Claude Code 是對話式的。您不需要完美的提示。從您想要的開始，然後細化：
[Claude 調查，嘗試一些東西]
[Claude 調整方法] 當第一次嘗試不正確時，您不會重新開始。您進行迭代。

​
中斷和引導

您可以在任何時刻重新導向 Claude，無需重新開始。執行以下任一操作：
  • 按 Esc 立即停止 Claude。正在執行的工具呼叫被取消，Claude 等待您的下一個指令。如果您有排隊的訊息，Claude Code 會接著發送它們。
  • 輸入更正並按 Enter 而不停止 Claude。訊息在輸入框上方顯示為已排隊。如果 Claude 正在執行工具呼叫，它會在這些呼叫完成後立即讀取訊息，在同一輪內進行調整，然後執行下一步。在 Claude 工作時排隊訊息涵蓋何時發送其他排隊項目。

​
委派，不要指示

想像委派給一位能力強大的同事。提供上下文和方向，然後相信 Claude 會找出詳細資訊：
您不需要指定要讀取哪些檔案或執行哪些命令。Claude 會找出來。

​
接下來

使用功能擴展

新增 Skills 和 MCP 連接

常見工作流程

典型任務的逐步指南