贊助商 Sora2Prompt AI, 免費 Sora 2 提示詞生成器

Claude Code 上下文管理

阅读时间：14 分钟中级

学习如何有效管理上下文，說明 Claude Code 更好地理解您的專案并提供更准确的结果。

Twitter
Instagram
Facebook
LinkedIn

理解 Claude Code 中的上下文

上下文是 Claude Code 用来理解您的專案并提供相关說明的資訊。有效的上下文管理对于获得准确、有用的响应至关重要，这些响应应与您的專案目标保持一致。

什么是上下文？

Claude Code 的上下文包括：

  • 当前对话 - 您与 Claude Code 最近的交互
  • 活动檔案 - 您当前正在处理的檔案
  • 專案结构 - 程式碼库的组织方式
  • 程式碼关系 - 程式碼不同部分之间的交互方式
  • 專案文件 - README 檔案、注释和其他文件

上下文視窗

Claude Code 有一个有限的"上下文視窗" - 它一次可以考虑的資訊量。有效管理这个視窗是获得最佳结果的关键：

  • 上下文太少：Claude Code 可能会错过重要資訊
  • 太多不相关的上下文：可能会稀释焦点并导致不太精确的响应
  • 恰到好处：聚焦、相关的上下文会带来最佳說明

專案级别的上下文管理

首先說明 Claude Code 在高层次上理解您的專案：

建立 CLAUDE.md 檔案

在專案根目录建立 CLAUDE.md 檔案可提供关键的高层次上下文：

# Project: MyAwesomeApp

## Purpose
MyAwesomeApp is a React-based web application that helps users manage their personal finances.

## Architecture
- Frontend: React with TypeScript
- State Management: Redux
- API: GraphQL with Apollo Client
- Authentication: Firebase Auth

## Key Directories
- /src/components: Reusable UI components
- /src/pages: Page components
- /src/state: Redux store and slices
- /src/api: GraphQL queries and mutations
- /src/utils: Utility functions

## Coding Standards
- We use ESLint with the Airbnb config
- Component names are PascalCase
- Utility functions are camelCase
- We use functional components with hooks
- Tests are in __tests__ directories

Claude Code 在分析您的專案时会自動读取此檔案。

專案概览命令

开始新会话时，给 Claude Code 提供專案概览：

claude "分析这个專案并提供其结构和目的的摘要"

这有助于 Claude Code 建立对程式碼库的初步理解。

定义專案特定术语

解释领域特定术语和專案行话：

claude "在我们的專案中，'Workspace' 指的是使用者的财务账户集合，'Envelope' 指预算类别"

这有助于 Claude Code 理解您的领域语言，实现更好的沟通。

任务特定的上下文管理

对于单个任务，为 Claude Code 提供所需的特定上下文：

引用相关檔案

明确提及与当前任务相关的檔案：

claude "我正在处理身份验证流程。请分析 src/auth/login.tsx、src/auth/register.tsx 和 src/services/authService.js"

这会将 Claude Code 的注意力集中在程式碼库最相关的部分。

解释相关元件

提供有关元件如何交互的上下文：

claude "Dashboard 元件（src/pages/Dashboard.tsx）顯示来自多个源的数据：AccountList 元件顯示来自 accountService 的账户，TransactionList 顯示来自 transactionService 的最近交易"

这有助于 Claude Code 理解程式碼不同部分之间的关系。

指定需求和约束

清楚地传达需求和限制：

claude "我需要实现数据匯出功能。它应该支援 CSV 和 JSON 格式，尊重使用者隐私設定，并与我们现有的權限系統（src/services/permissionService.js）配合使用"

这确保 Claude Code 的建議符合您的特定要求。

進階上下文管理技术

这些進階技术可以說明您更有效地管理上下文：

建立特定上下文的会话

为不同上下文启动新的 Claude Code 会话：

  • 专注于前端 UI 元件的会话
  • 用于后端 API 開發的单独会话
  • 另一个用于資料庫模式工作的会话

这可以防止上下文混合，并說明 Claude Code 保持对特定领域的关注。

使用 .claudeignore 檔案

建立 .claudeignore 檔案以排除不相关的目录：

# Dependencies
node_modules/
vendor/

# Build artifacts
dist/
build/

# Large data files
data/large-dataset.json
public/assets/videos/

# Testing resources
**/__mocks__/
**/__fixtures__/

这可以防止 Claude Code 在其上下文中包含不相关的檔案，从而提高关注度和性能。

必要时重置上下文

切换主题或开始新任务时，重置对话上下文：

claude "让我们重新开始。我现在正在处理支付处理模組。"

这向 Claude Code 发出信号，表明之前的上下文可能不再相关。

针对特定任务最佳化上下文

不同的任务需要不同类型的上下文。以下是如何针对常见场景进行最佳化：

偵錯上下文

无效

claude "修复我程式碼中的錯誤"

有效

claude "說明偵錯这个问题：使用者登入后访问 /profile 时出现 404 錯誤。錯誤发生在 ProfilePage.tsx 第 24 行。身份验证流程在 AuthContext.tsx 中处理，路由在 AppRoutes.tsx 中定义"

功能实现上下文

无效

claude "实现暗黑模式"

有效

claude "为我们的 React 应用实现暗黑模式。我们使用 Tailwind CSS 进行样式设计（参见 tailwind.config.js），全局状态用 Redux 管理（参见 src/state/store.ts）。主题应该使用 localStorage 持久化，并尊重使用者操作系統偏好設定。"

程式碼审查上下文

无效

claude "审查我的程式碼"

有效

claude "审查 src/services/userService.ts，重点关注安全性、錯誤处理和性能。我们遵循 OWASP 安全指南，并使用 src/utils/errorHandling.ts 中的錯誤处理模式。此服务将在生产環境中使用，可能有数千名并发使用者。"

排查上下文问题

当 Claude Code 的响应似乎偏离目标时，请考虑这些与上下文相关的问题和解决方案：

上下文问题的症状

  • 过时的資訊 - Claude Code 引用已更改的旧程式碼
  • 缺少引用 - Claude Code 似乎不知道相关檔案
  • 建議不一致 - Claude Code 的建議与專案模式不匹配
  • 术语混淆 - Claude Code 误解了特定领域的语言

上下文问题的解决方案

  • 明确刷新上下文:
    claude "请重新分析 src/components/auth/ 的当前状态，以确保您拥有最新程式碼"
  • 重定向关注点:
    claude "让我们专门关注 AuthContext.tsx 和 LoginPage.tsx 中的身份验证流程"
  • 澄清專案模式:
    claude "我们的專案使用存储库模式进行数据访问。请参阅 UserRepository.ts 以瞭解我们如何建置这些元件的示例"
  • 在需要时开始新会话以获得完全干净的上下文

下一步

既然您已经掌握了上下文管理，请探索这些相关指南：