管理克勞德·科德的背景：實用手冊

Anthropic 的 Claude Code 和更廣泛的 Claude 家族現在為開發者提供了前所未有的控制權 多少 模型看到並 多麼深刻 原因就在於此。最近的產品更新（尤其是 Sonnet 4 的百萬級令牌上下文視窗和 Claude 擴展的「思考」控制項）使上下文管理更加強大，也更加重要：您可以在單個會話中處理整個存儲庫——但前提是您精心設計了提示符、文件和會話狀態的結構。本文將介紹如何可靠地管理 Claude Code 的上下文：命令和用法、思考預算控制、CLAUDE.md 模式、子代理工作流程、進階使用者提示、故障排除以及可複製貼上的具體程式碼範例。

什麼是 克勞德·科德?

Claude Code 是 Anthropic 的 代理編碼 CLI ——一款終端優先的工具，將您的開發環境連接到 Claude 模型，以便助手可以從終端機讀取您的程式碼庫、運行命令、編輯檔案、運行測試、建立提交並執行多步驟工作流程。它的建置旨在讓 AI 能夠「駐留在」您的 shell 中並對您的程式碼庫進行操作，其功能包括程式碼庫掃描、斜線命令、子代理程式（具有獨立上下文的專用助手）以及用於外部工具的模型上下文協定 (MCP) 整合。

---

我為什麼要管理 上下文 克勞德·科德？

因為上下文 = 相關性 + 成本 + 安全性。如果不加以控制，過長的歷史記錄會導致：

• 令牌使用率更高（成本更高，回應更慢）。
• 上下文漂移（舊的/不相關的資訊混淆輸出）。
• 資訊外洩（秘密或敏感日誌滯留在會話中）。
  管理上下文可使輸出保持準確、可預測且更便宜。

Claude Code 如何組織和保存專案上下文？

Claude Code 是一個代理 CLI，它將你的程式碼庫、工具和配置視為一流的上下文來源。它讀取專案文件， CLAUDE.md、本機工具和已配置的 MCP 伺服器；它還支援每個子代理程式擁有自己的上下文視窗（有助於避免污染主對話）。使用此功能可以將主級策略與專用代理記憶體（例如，測試運行器、程式碼審查器）分開。

Claude Code 如何取得 repo 上下文和說明文件？

• 它會掃描工作目錄以及您新增的任何額外目錄（--add-dir).
• 它尋找 .claude/ 子資料夾（指令、代理）和 CLAUDE.md.
• 您可以連接模型上下文協定 (MCP) 伺服器以進行外部工具存取；Claude Code 可以將這些工具繼承到其工具集中。

我可以採取什麼方法來管理 Claude 程式碼中的上下文？

1. 掌握基本的 CLI 指令。將可重複使用的提示符號以斜線命令的形式儲存在 .claude/commands/ 目錄中，以避免重複貼上長提示符號。
2. 合理設計 CLAUDE.md 檔案。將 CLAUDE.md 新增至程式碼庫根目錄，用於定義目標、允許使用的工具、程式碼樣式、升級規則以及有用的斜線命令。 （Claude Code 會自動讀取該檔案並將其作為權威指南。）
3. 使用子代理進行任務隔離－每個子代理程式擁有獨立的上下文視窗和工具權限，從而避免主會話被輪詢。將子代理程式儲存在 .claude/agents/ 目錄中，並對其進行版本控制。

基本的上下文管理命令有哪些

以下是在 Claude Code 中管理對話狀態最常用的指令。我列出了它們的行為、範例用法、推薦場景以及相關 CLI 標誌的指向。

---

/clear —“重新開始”

它的作用： 清除會話中的目前對話記錄，以便後續提示從頭開始。 REPL 會話將繼續，但來回的訊息將從模型的上下文中移除。 （專案文件和 CLAUDE.md 仍然可供 Claude Code 訪問。

何時使用

• 完成一項功能或票證後，您需要一個乾淨的會話來執行不相關的任務。
• 如果會話中累積了許多探索性轉折，答案就會變得越來越差。
• 在將會話交給另一個使用者/代理之前，避免洩漏先前的對話狀態。

使用

# in the interactive REPL

/clear

注意事項和提示

• /clear 對該會話的對話歷史記錄具有破壞性；使用 /resume/--continue 如果您想返回磁碟上儲存的舊會話。

---

/compact —“總結與濃縮”

它的作用： 將當前對話壓縮為簡短的摘要，保留關鍵事實和決策，然後用該摘要替換冗長的歷史記錄，以便會話能夠繼續進行而不會丟失重要的上下文。這在保持會話連續性的同時減少了令牌的使用。

何時使用

• 當您想要保留執行緒的重要狀態但減少令牌佔用空間時。
• 在執行一項漫長的新任務之前，否則上下文視窗就會受到限制。
• 當您想要一個簡潔的會話「記憶」同時保留關鍵決策。

使用

# in the interactive REPL

/compact
# or with an instruction to guide the summary

/compact Summarize decisions, open TODOs, and config changes only

注意事項和提示

• auto-compact, microcompact以及其他智慧壓縮行為，當對話長度在某些建置或設定中達到限制時，可能會自動運作；這些功能正在逐步推出，可能會出現在您的安裝或託管環境中。 （社群和更新日誌討論了微壓縮和自動壓縮行為。）

---

--continue, --resume和會話控制（CLI 等級）

他們做什麼： 從 CLI 控制會話持久性和選擇。

• claude --continue claude -c) — 重新開啟並繼續目前專案目錄中最近的對話。
• claude --resume claude -r <session-id>) — 顯示互動式選擇器（或透過 ID 恢復特定會話）。當您儲存了多個會話並想要選擇一個繼續時，此功能非常有用。

使用示例

# continue the most recent session

claude --continue

# open an interactive session picker

claude --resume

# resume by id (non-interactive)

claude --resume 550e8400-e29b-41d4-a716-446655440000

---

與上下文相關的互動模式捷徑（終端使用者體驗）

• Ctrl+L — 清除終端螢幕（視覺），但 保持 對話歷史記錄。使用 /clear 真正重置歷史。
• Ctrl+D — 退出會話（EOF）。
• Ctrl+C — 取消目前產生。
  這些是便利的控制；它們只影響終端行為，除非你明確運行 /clear or --continue/--resume.

---

其他與上下文相關的控制和標誌

• --add-dir <path> — 包括 Claude 可以讀取的附加目錄（有利於確定 Claude 可以存取的內容並減少不必要的檔案讀取）。
• --allowedTools — 預先允許工具，以便 Claude 可以運行它們而無需重複的權限提示（減少來回和嘈雜的工具權限對話框）。
• 斜線指令 (/.claude/commands/ 或 MCP 提供）－儲存經常使用的、令牌高效的提示；呼叫斜線指令比重複貼上長提示更便宜。

我應該如何設計 CLAUDE.md 檔案來控制專案上下文？

CLAUDE.md 是什麼以及它為何重要

CLAUDE.md 是一個預檢專案層級提示，Claude Code 在啟動程式碼庫時會自動讀取。使用它來輸入關於專案的簡短、可操作且穩定的事實（名詞、架構、標準）。由於模型會將 CLAUDE.md 檔案提取到提示中，因此精心編寫的檔案可以減少重複貼上相同資訊的需要，並節省寶貴的代幣預算。

CLAUDE.md：實用範本（建議）

遵循這些規則：簡短（盡可能 100-200 行）、分層（全域 → 項目 → 子目錄覆蓋）和機器可讀的部分。

# CLAUDE.md — top of repository

Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)

# Conventions

- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)

# What I'm asking Claude to do

- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.

注意：

• 將高價值項目（API、重要文件、基礎架構指令、測試指令）放在第一位。
• 使用單獨的 CLAUDE.md 當不同的模組具有不同的約定時，子目錄中的檔案；Claude 將組合併優先考慮更具體的檔案。

如何組合工作流程和子代理程式來管理上下文和並行化工作？

什麼是子代理？

子代理程式是克勞德代碼模式，其中主代理將離散任務委託給下屬代理（例如： frontend-agent, backend-agent, qa-agent)，然後主代理協調它們的輸出。子代理程式可讓您並行處理系統的不同部分，而無需將所有內容塞進一個聊天中。

範例工作流程：功能實作（並行代理）

1. main-agent 讀取 CLAUDE.md，建立計劃。
2. frontend-agent （子代理）取得焦點上下文：UI 合約、故事書、特定文件。
3. backend-agent （子代理程式）取得 DB 模式、API 合約並實現端點。
4. qa-agent 執行測試，將失敗的測試寫回 main-agent.
5. main-agent 協調提交、合併請求並更新 CLAUDE.md。

CLI 模式：

# start main session

claude --session main

# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)

claude --session frontend --cwd frontend/

提示：建立作用域 CLAUDE.md 子目錄下的檔案（frontend/CLAUDE.md, backend/CLAUDE.md) 因此每個子代理程式都從其所需的最小上下文開始。

子代理範例： .claude/agents/code-reviewer.md

---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---

You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.

---

高級用戶有哪些技巧可以保持環境健康並降低成本？

1）保持 CLAUDE.md 精簡且層次分明

避免使用龐大的 CLAUDE.md 檔案。使用一個全域檔案來管理開發者的偏好設置，並使用小型模組檔案來管理特定區域。請參閱先前的模板。

2）對動詞使用斜線指令，對名詞使用 CLAUDE.md

讓 CLAUDE.md 成為 事實 （存在哪些檔案、體系結構）和斜線指令的位置 程序 （建立測試，運行重構）。這可以避免每次會話都重複發送程式邏輯。社區智慧強調了這種分離。

3）詳細模式+計劃模式作為調試工具

當 Claude 行為異常時，請執行詳細查看確切上下文，並使用計劃模式強制執行您可以在編輯之前批准的明確計劃。

4）仔細考慮預算

從預設/最小思考令牌開始，僅在任務需要多步驟推理（例如複雜的重構、形式化驗證）時增加。使用較低的預算進行常規編輯。

5）儀器輸出提交

有鉤子可以自動運行測試並將其輸出附加到會話（bash 模式 ! 運行 shell 命令並包含輸出作為上下文）。使用提交鉤子創建帶有訊息的清晰原子提交。

當上下文「遺失」或克勞德忘記指令時，我該如何排除故障？

常見症狀和解決方法

• 症狀： Claude 忽略了 CLAUDE.md 或先前的指示。
• 修正： 確認檔案位於會話的目前工作目錄中；檢查是否有更具體的子目錄 CLAUDE.md 覆寫它；使用詳細模式查看目前提示。
• 症狀： 長時間會話後效能會下降（模型「忘記」了早期部分）。
• 修正： 壓縮會話：將穩定的事實提取到 CLAUDE.md 檔案中，或將對話的部分內容快照到檔案中並引用，而不是重複。也可以考慮重啟短會話，並僅傳遞簡潔的上下文。
• 症狀： 延伸思考耗費的時間過長或超時。
• 修正： 降低 thinking_budget，將任務分解為更小的子問題，或者如果需要極大的預算，可以運行批量離線分析。 Anthropic 建議在最佳思考預算超過約 32K 個 token 時進行批量處理，以避免超時。

結論

在 Claude Code 中管理上下文現在是一個多維問題：模型選擇、子代理設計、 CLAUDE.md 紀律、思維預算和工具架構都是相互作用的。先投入 1-2 小時寫一份清晰的 CLAUDE.md，建立 2-3 個專注的子代理，並添加代幣和思考預算的使用工具——您將立即看到可靠性、成本可預測性和團隊生產力的提高。

透過 CometAPI 使用 Claude 程式碼

CometAPI 是一個統一的 API 平台，它將來自領先供應商（例如 OpenAI 的 GPT 系列、Google 的 Gemini、Anthropic 的 Claude、Midjourney、Suno 等）的 500 多個 AI 模型聚合到一個開發者友好的介面中。透過提供一致的身份驗證、請求格式和回應處理，CometAPI 顯著簡化了將 AI 功能整合到您的應用程式中的過程。無論您是建立聊天機器人、影像產生器、音樂作曲家，還是資料驅動的分析流程，CometAPI 都能讓您更快地迭代、控製成本，並保持與供應商的兼容性——同時也能充分利用整個 AI 生態系統的最新突破。

我們很高興地宣布 CometAPI 現在完全支援強大的 Claude 程式碼。 您只需安裝Claude Code並使用取得的Comet API金鑰和基底位址進行驗證，即可在Claude Code上使用Comet API模型。

為什麼要透過 CometAPI 使用 claude 程式碼？

頂級人工智慧功能：使用專為開發人員構建的模型輕鬆生成、調試和優化程式碼。

• 靈活的模型選擇：我們全面的模型系列使您能夠更無縫地進行開發。
• 無縫整合：API 始終可用。只需幾分鐘即可將 Claude Code 直接整合到您現有的工作流程中。
• 透過 CometAPI 使用 Claude 程式碼將節省更多成本CometAPI提供的API比官方價格優惠20%，並由官方更新最新型號。最新型號為 克勞德作品 4.1.

準備好使用克勞德代碼了嗎？請諮詢 API指南 有關詳細說明。

參見 如何透過 CometAPI 安裝和運行 Claude 程式碼？