Claude Code 作为 Anthropic 推出的强大命令行 AI 编程助手，其核心优势在于能够深度理解项目上下文并执行复杂任务。而 AGENTS.md 文件则是定义 Agent 行为、角色设定及工作流规范的关键配置文件。许多开发者在初次接触时，往往困惑于如何正确安装和配置该文件以激活高级功能。本文将提供一份严谨的步骤清单，帮助您在本地环境中高效完成 Claude Code 的 Agent 配置。
环境准备与前置检查
在开始安装之前，确保您的开发环境已满足以下基础要求。首先，您需要拥有有效的 Anthropic API 密钥，这是调用 Claude 模型服务的凭证。其次，确认您的系统已安装 Node.js（建议 v18 或更高版本）以及 npm 包管理器。对于 macOS 和 Linux 用户，还需确保安装了 Homebrew 或相应的包管理工具，以便后续处理系统依赖。此外，建议使用最新的 VS Code 或 JetBrains IDE，以获得最佳的终端集成体验。这些准备工作将确保后续的安装过程顺畅无阻，避免因环境缺失导致的配置失败。
全局安装 Claude Code CLI
Claude Code 主要通过命令行界面（CLI）运行。打开终端窗口，输入以下命令以全局安装该工具：
npm install -g @anthropic-ai/claude-code
安装完成后，可以通过运行 claude --version 来验证安装是否成功。如果返回版本号，说明 CLI 已成功注册到系统路径中。接下来，初始化认证流程，运行 claude login 并按照提示登录您的 Anthropic 账户。这一步骤至关重要，它将建立本地环境与云端服务的安全连接，为后续加载 AGENTS.md 配置奠定安全基础。
创建与配置 AGENTS.md 文件
AGENTS.md 并非传统意义上的“安装”软件包，而是项目级别的配置文件。要在特定项目中启用 Agent 模式，您需要在项目根目录下创建一个名为 AGENTS.md 的文件。该文件采用 Markdown 格式编写，用于定义 AI 助手的角色、约束条件及特殊指令。例如，您可以定义：“你是一个资深 Python 专家，专注于代码重构与安全审计。”或者设置特定的输出格式要求。创建文件后，当您在该项目目录下运行 claude 命令时，系统会自动读取此文件内容，并将其注入到每次对话的系统提示词中，从而实现个性化的 Agent 行为。
验证配置与调试技巧
配置完成后，建议在测试项目中验证 AGENTS.md 是否生效。在项目根目录启动 claude，尝试提出一个涉及角色设定的问题。如果 AI 的回答严格遵循了文件中定义的语气、风格或逻辑限制，则表明配置成功。若未生效，请检查文件命名是否正确（区分大小写），并确保位于项目最外层根目录。此外，可使用 claude status 命令查看当前会话状态，确认系统提示词中是否包含了自定义内容。通过这种迭代式的调试方法，您可以不断优化 Agent 的行为表现，使其更贴合实际开发需求。
本文链接：https://ai-claudecode.cn/jiaochen/rhazclaude-code-agents-md-agentpzzn/
