在使用 Claude Code 进行大型项目开发时，开发者常常会遇到一个瓶颈：模型能够处理的上下文窗口是有限的。虽然 Anthropic 提供了强大的长文本处理能力，但在本地配置中，通过 AGENTS.md 文件来管理项目指令和上下文仍然是关键。本文将详细介绍如何优化 AGENTS.md 以应对上下文长度限制，提升编码效率。
理解上下文长度与 AGENTS.md 的关系
Claude Code 的上下文长度限制指的是模型在一次交互中能“记住”的最大 token 数量。当项目代码库庞大或对话历史过长时，超出限制会导致信息丢失或响应错误。AGENTS.md 是一个位于项目根目录的 Markdown 文件，用于向 AI 助手提供项目背景、编码规范和任务指令。合理配置此文件，可以有效减少冗余上下文，将有限的窗口留给核心代码逻辑。
首先，你需要明确 AGENTS.md 的核心作用：它不是代码本身，而是指导 AI 如何理解代码的元数据。因此，避免在文件中放入完整的代码片段或冗长的历史日志，而应专注于提炼关键规则。例如，只定义项目使用的框架版本、特定的命名约定以及必须遵循的安全准则。这种精简策略能显著降低每次请求时的 token 消耗，从而间接扩展了可用的上下文空间。
优化 AGENTS.md 结构的实战步骤
为了最大化利用上下文资源，建议按照以下结构编写 AGENTS.md：
1. 项目概述与环境配置
简要说明项目的技术栈（如 React, Node.js, Python 等）及其版本。明确指出依赖管理工具（如 npm, pip, cargo）。这一部分帮助 AI 快速建立环境认知，无需在后续对话中反复确认基础信息。
2. 核心编码规范
列出最重要的几条编码风格要求，例如缩进格式、注释语言、函数命名规则。对于复杂的项目，可以引用外部文档而非在此处详述。保持简洁，仅包含 AI 执行任务时必须遵守的铁律。
3. 任务特定指令
如果当前正在进行特定模块的开发，可以在文件中添加临时指令，指示 AI 重点关注哪些目录或文件类型。一旦任务完成，应及时移除这些临时指令，以免占用宝贵的上下文窗口。
在实际操作中，你可以使用以下模板作为起点：
# Project Guidelines
- Tech Stack: Next.js 14, TypeScript, Tailwind CSS
- Linting: ESLint with Airbnb config
- Testing: Jest for unit tests, Playwright for E2E
- Note: Always prioritize performance optimization in component rendering.处理超长上下文的替代方案
即使优化了 AGENTS.md，在某些极端情况下，上下文仍可能不足。此时，可以采取以下措施：
分模块交互：
不要试图让 AI 一次性理解整个代码库。将大项目拆分为独立的功能模块，针对每个模块单独创建子目录或分支，并在各自的上下文中进行开发。这样可以确保每次对话都集中在较小的代码片段上。
定期清理对话历史：
在 Claude Code 界面中，适时启动新的会话。旧的对话历史会累积大量 token，导致新任务的起始上下文拥挤。养成“一事一议”的习惯，有助于维持高效的交互状态。
利用摘要功能：
如果之前的对话中有重要的决策或架构设计，可以使用 AI 生成一份简短的摘要，并将其追加到 AGENTS.md 中。这样，新的会话可以直接读取摘要，而无需重新加载整个历史记录。
通过上述方法，你可以更灵活地驾驭 Claude Code 的上下文长度限制。关键在于保持 AGENTS.md 的精炼性和针对性，同时结合良好的项目管理习惯，从而实现高效、稳定的 AI 辅助开发体验。
本文链接：https://jianli-bf.com.cn/DeepSeek/claude-code-agents-md-sxwcdxztpzn/
