CLAUDE.md 与 AGENTS.md 配置文件完全指南 | 极客日志

TypeScriptNode.jsAI大前端

CLAUDE.md 与 AGENTS.md 配置文件完全指南

综述由AI生成CLAUDE.md 和 AGENTS.md 两个 AI 编程助手配置文件的作用、格式及最佳实践。CLAUDE.md 是 Claude Code 专属配置，AGENTS.md 是跨平台开放标准。文章解析了文件位置优先级、内容规范（常用命令、代码风格、架构说明等），并提供了 TaskFlow 全栈项目的完整配置示例。通过分层配置和团队协作策略，帮助开发者让 AI 更好地理解项目上下文，提升编码效率。

安卓系统发布于 2026/4/5更新于 2026/5/2025 浏览

CLAUDE.md 与 AGENTS.md 配置文件完全指南

本文详细介绍 CLAUDE.md 和 AGENTS.md 两个配置文件的作用、格式和最佳实践，包括文件位置优先级、内容规范、实践案例。适合已使用过 Claude Code、Cursor 等 AI 编程助手的进阶开发者阅读。

1. 为什么需要这两个文件

在 AI 辅助编程的时代，我们已经习惯了让 AI 帮我们写代码、调试、重构。但你有没有遇到过这样的情况：

AI 生成的代码风格和项目规范不一致
每次都要重复告诉 AI 项目的构建命令
AI 不知道项目的特殊约定，总是犯同样的错误
团队成员使用 AI 时，得到的结果参差不齐

说白了，这些问题的根源在于：AI 不了解你的项目上下文。

每个项目都有一个 README.md 供人类阅读，但 AI 编程助手需要的信息和人类不同。人类可以通过经验推断很多细节，而 AI 需要明确、具体的指令。

这就是 CLAUDE.md 和 AGENTS.md 存在的意义——它们是写给 AI 的项目说明书。

打个比方：README.md 像是产品说明书，而 CLAUDE.md/AGENTS.md 像是给新员工的入职培训手册——事无巨细，确保 AI 能按照你的期望工作。

1.1 两个文件的定位

文件	定位	适用工具	标准化程度
`CLAUDE.md`	Claude Code 专属配置文件	Claude Code	Anthropic 官方标准
`AGENTS.md`	通用 AI 编程代理配置文件	Cursor、GitHub Copilot、Codex、Gemini CLI 等	开放标准（60,000+ 项目采用）

简单来说：

CLAUDE.md 是 Claude Code 的"专属记忆"，每次启动时自动加载
AGENTS.md 是一个跨平台的开放标准，被主流 AI 编程工具广泛支持

1.2 传统 README.md vs AI 配置文件

传统的 README.md 是写给人看的，它关注的是：

项目是什么
如何安装和使用
功能特性介绍

而 CLAUDE.md 和 AGENTS.md 是写给 AI 看的，它们关注的是：

如何构建和测试这个项目
代码风格和命名规范是什么
有哪些特殊约定和注意事项
遇到特定问题应该怎么处理

2. CLAUDE.md 深度解析

2.1 什么是 CLAUDE.md

CLAUDE.md 是 Anthropic 为 Claude Code 设计的配置文件。当你启动 Claude Code 时，它会自动读取这个文件的内容并加入到对话上下文中。

这意味着你在 CLAUDE.md 中写的任何内容，Claude 在整个会话过程中都会"记住"。

2.2 文件位置与优先级

Claude Code 支持在多个位置放置 CLAUDE.md，并按以下优先级读取：

相关免费在线工具

RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。在线工具，Mermaid 预览与可视化编辑在线工具，online
随机西班牙地址生成器
随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。在线工具，随机西班牙地址生成器在线工具，online
Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online
Markdown转HTML
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。在线工具，Markdown转HTML在线工具，online

优先级从高到低：
1. 当前工作目录的 CLAUDE.local.md（本地配置，不提交到 git）
2. 当前工作目录的 CLAUDE.md（项目配置，提交到 git）
3. 父目录的 CLAUDE.md（适用于 Monorepo）
4. ~/.claude/CLAUDE.md（全局配置，适用于所有项目）

my-monorepo/
├── CLAUDE.md # 根目录配置（通用规则）
├── packages/
│   ├── frontend/
│   │   └── CLAUDE.md # 前端子项目配置
│   └── backend/
│       └── CLAUDE.md # 后端子项目配置
└── CLAUDE.local.md # 本地私有配置（.gitignore）

# 常用命令
## 构建
- `npm run build` - 构建生产版本
- `npm run dev` - 启动开发服务器
## 测试
- `npm test` - 运行所有测试
- `npm test -- --watch` - 监听模式运行测试
- `npm run test:coverage` - 生成覆盖率报告
## 代码检查
- `npm run lint` - 运行 ESLint
- `npm run typecheck` - 运行 TypeScript 类型检查

# 代码风格
## JavaScript/TypeScript
- 使用 ES modules（import/export），不使用 CommonJS（require）
- 优先使用解构导入：`import { foo } from 'bar'`
- 使用 const 声明不变的变量，let 声明需要重新赋值的变量
- 函数优先使用箭头函数
- 字符串使用单引号
## 命名规范
- 组件使用 PascalCase：`UserProfile.tsx`
- 工具函数使用 camelCase：`formatDate.ts`
- 常量使用 UPPER_SNAKE_CASE：`MAX_RETRY_COUNT`
- CSS 类名使用 kebab-case：`user-profile`

# 项目架构
## 目录结构
- `src/components/` - React 组件
- `src/hooks/` - 自定义 Hooks
- `src/utils/` - 工具函数
- `src/api/` - API 请求封装
- `src/types/` - TypeScript 类型定义
## 关键文件
- `src/config/index.ts` - 全局配置
- `src/store/index.ts` - 状态管理入口
- `src/router/index.tsx` - 路由配置

# 开发规范
## Git 提交
- 提交信息格式：`<type>(<scope>): <subject>`
- type 可选值：feat, fix, docs, style, refactor, test, chore
- 示例：`feat(user): add login functionality`
## 注意事项
- 不要直接修改 `node_modules` 中的代码
- 环境变量必须以 `VITE_` 开头才能在前端使用
- API 请求统一使用 `src/api/request.ts` 中的封装方法

# TaskFlow 项目配置
## 项目概述
TaskFlow 是一个基于 React + Node.js 的任务管理系统，支持团队协作、任务分配、进度追踪等功能。
## 技术栈
- 前端：React 18 + TypeScript + Vite + TailwindCSS
- 后端：Node.js + Express + TypeScript
- 数据库：PostgreSQL + Prisma ORM
- 测试：Jest + React Testing Library
## 常用命令
### 开发
- `pnpm dev` - 同时启动前后端开发服务器
- `pnpm dev:client` - 仅启动前端（端口 5173）
- `pnpm dev:server` - 仅启动后端（端口 3000）
### 构建
- `pnpm build` - 构建前后端
- `pnpm build:client` - 仅构建前端
- `pnpm build:server` - 仅构建后端
### 测试
- `pnpm test` - 运行所有测试
- `pnpm test:client` - 运行前端测试
- `pnpm test:server` - 运行后端测试
- `pnpm test:e2e` - 运行端到端测试
### 数据库
- `pnpm db:migrate` - 运行数据库迁移
- `pnpm db:seed` - 填充测试数据
- `pnpm db:studio` - 打开 Prisma Studio
### 代码质量
- `pnpm lint` - 运行 ESLint
- `pnpm typecheck` - 运行类型检查
- `pnpm format` - 运行 Prettier 格式化
## 代码风格
### TypeScript
- 严格模式开启，不允许 any 类型
- 优先使用 interface 定义对象类型
- 使用 type 定义联合类型和工具类型
- 函数返回值必须显式声明类型
### React
- 使用函数组件 + Hooks，不使用类组件
- 组件 props 使用 interface 定义
- 状态管理使用 Zustand
- 表单处理使用 React Hook Form + Zod
### API 设计
- RESTful 风格
- 响应格式：`{ code: number, data: T, message: string }`
- 错误码：200 成功，400 参数错误，401 未授权，500 服务器错误
## 目录结构
taskflow/
├── client/ # 前端代码
│   ├── src/
│   │   ├── components/ # 通用组件
│   │   ├── features/ # 功能模块（按业务划分）
│   │   ├── hooks/ # 自定义 Hooks
│   │   ├── lib/ # 第三方库封装
│   │   ├── stores/ # Zustand stores
│   │   └── types/ # 类型定义
│   └── tests/ # 前端测试
├── server/ # 后端代码
│   ├── src/
│   │   ├── controllers/ # 控制器
│   │   ├── services/ # 业务逻辑
│   │   ├── middlewares/ # 中间件
│   │   ├── routes/ # 路由定义
│   │   └── utils/ # 工具函数
│   └── tests/ # 后端测试
├── prisma/ # Prisma 配置和迁移
└── e2e/ # 端到端测试
## 开发规范
### Git 工作流
- 主分支：main（生产）、develop（开发）
- 功能分支：feature/xxx
- 修复分支：fix/xxx
- 提交前必须通过 lint 和 typecheck
### 提交信息格式
<type>(<scope>): <subject>
<body>
<footer>
type 可选值：
- feat: 新功能
- fix: 修复 bug
- docs: 文档更新
- style: 代码格式（不影响功能）
- refactor: 重构
- test: 测试相关
- chore: 构建/工具相关
### Code Review 要求
- 每个 PR 至少需要一个 approve
- PR 标题格式与提交信息一致
- 必须关联对应的 Issue
## 注意事项
### 环境变量
- 前端环境变量以 `VITE_` 开头
- 后端环境变量在 `.env` 文件中配置
- 敏感信息不要提交到代码库
### 数据库操作
- 所有数据库操作通过 Prisma 进行
- 复杂查询使用 Prisma 的 raw query
- 迁移文件不要手动修改
### 测试要求
- 新功能必须有对应的单元测试
- 核心业务逻辑测试覆盖率 > 80%
- API 接口必须有集成测试
## 常见问题
### Q: 启动报错 "Cannot find module"
A: 运行 `pnpm install` 重新安装依赖
### Q: 数据库连接失败
A: 检查 `.env` 中的 `DATABASE_URL` 配置，确保 PostgreSQL 服务已启动
### Q: TypeScript 类型错误
A: 运行 `pnpm typecheck` 查看详细错误，确保类型定义正确

# 在项目目录中启动 Claude Code
claude
# 运行初始化命令
> /init

touch CLAUDE.md

## 重要规则
**IMPORTANT**: 所有 API 请求必须经过 `src/api/request.ts` 封装
**YOU MUST**: 提交代码前运行 `pnpm lint` 和 `pnpm typecheck`
**NEVER**: 不要在前端代码中硬编码 API 地址

特性	CLAUDE.md	AGENTS.md
适用工具	Claude Code 专属	跨平台通用
标准化组织	Anthropic	Agentic AI Foundation (Linux Foundation)
文件位置	支持多级目录和全局配置	主要在项目根目录和子目录
内容格式	自由 Markdown	自由 Markdown
优先级机制	支持 local 文件覆盖	就近原则（最近的文件优先）

优先级从高到低：
1. 用户在聊天中的直接提示词（最高优先级）
2. 距离当前编辑文件最近的 AGENTS.md
3. 根目录的 AGENTS.md

my-monorepo/
├── AGENTS.md # 根目录（通用规则）
├── packages/
│   ├── web/
│   │   └── AGENTS.md # Web 子项目（前端规则）
│   ├── api/
│   │   └── AGENTS.md # API 子项目（后端规则）
│   └── shared/
│       └── AGENTS.md # 共享库（库开发规则）

# AGENTS.md
## Project Overview
TaskFlow is a task management system built with React and Node.js. This is a monorepo managed by pnpm workspaces.

## Setup Commands
- Install dependencies: `pnpm install`
- Start dev server: `pnpm dev`
- Run tests: `pnpm test`
- Build for production: `pnpm build`

## Code Style
- Use TypeScript strict mode
- Use ESLint + Prettier for formatting
- Follow Airbnb style guide
- Use functional components with hooks (no class components)

## Testing Instructions
- Find CI plans in `.github/workflows/`
- Run `pnpm test` before committing
- Ensure all tests pass before creating PR
- Write unit tests for new features

## PR Instructions
- Title format: `[<scope>] <description>`
- Link related issues in PR description
- Request review from at least one team member
- Squash commits before merging

# AGENTS.md
## Project Overview
TaskFlow is a full-stack task management application.
- Frontend: React 18 + TypeScript + Vite
- Backend: Node.js + Express + TypeScript
- Database: PostgreSQL + Prisma
- Package Manager: pnpm (monorepo)
## Setup Commands
- Install deps: `pnpm install`
- Start dev: `pnpm dev`
- Run tests: `pnpm test`
- Build: `pnpm build`
- Lint: `pnpm lint`
- Type check: `pnpm typecheck`
## Database Commands
- Run migrations: `pnpm db:migrate`
- Seed data: `pnpm db:seed`
- Open Prisma Studio: `pnpm db:studio`
## Code Style Guidelines
### TypeScript
- Strict mode enabled, no `any` types
- Prefer `interface` for object types
- Explicit return types for functions
- Use `type` for unions and utility types
### React
- Functional components only
- Use Zustand for state management
- Use React Hook Form + Zod for forms
- Component files use PascalCase
### API Design
- RESTful conventions
- Response format: `{ code, data, message }`
- Error codes: 200 OK, 400 Bad Request, 401 Unauthorized, 500 Server Error
## Project Structure
taskflow/
├── client/ # Frontend (React)
│   ├── src/
│   │   ├── components/ # Shared components
│   │   ├── features/ # Feature modules
│   │   ├── hooks/ # Custom hooks
│   │   ├── stores/ # Zustand stores
│   │   └── types/ # Type definitions
├── server/ # Backend (Express)
│   ├── src/
│   │   ├── controllers/ # Route handlers
│   │   ├── services/ # Business logic
│   │   ├── middlewares/ # Express middlewares
│   │   └── routes/ # Route definitions
├── prisma/ # Database schema & migrations
└── e2e/ # End-to-end tests
## Testing Instructions
- Check CI config in `.github/workflows/ci.yml`
- Run `pnpm test` for unit tests
- Run `pnpm test:e2e` for E2E tests
- Coverage target: 80% for core business logic
- All tests must pass before PR merge
## PR Instructions
- Title format: `<type>(<scope>): <description>`
- Types: feat, fix, docs, style, refactor, test, chore
- Link related issues using `Closes #<issue_number>`
- Request review from at least one maintainer
- Ensure CI passes before requesting review
## Security Notes
- Never commit `.env` files
- Use environment variables for secrets
- Sanitize all user inputs
- Use parameterized queries (Prisma handles this)
## Common Issues
### "Module not found" error
Run `pnpm install` to reinstall dependencies.
### Database connection failed
Check `DATABASE_URL` in `.env` and ensure PostgreSQL is running.
### Type errors after pulling
Run `pnpm typecheck` and fix any type mismatches.

# .aider.conf.yml
read:
  - AGENTS.md

// .gemini/settings.json
{
  "contextFileName": "AGENTS.md"
}

# 重命名文件并创建符号链接保持兼容
mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md

# 创建项目目录
mkdir taskflow && cd taskflow
# 初始化 pnpm
pnpm init
# 创建 Monorepo 结构
mkdir -p client/src server/src prisma e2e
# 创建配置文件
touch CLAUDE.md AGENTS.md .gitignore

# TaskFlow 项目配置
这是一个基于 React + Node.js 的任务管理系统，使用 pnpm monorepo 管理。
## 快速开始
# 安装依赖
pnpm install
# 启动开发环境
pnpm dev
# 运行测试
pnpm test
## 技术栈
| 层级 | 技术 |
|------|------|
| 前端 | React 18, TypeScript, Vite, TailwindCSS, Zustand |
| 后端 | Node.js, Express, TypeScript |
| 数据库 | PostgreSQL, Prisma ORM |
| 测试 | Jest, React Testing Library, Supertest |
## 代码规范
### TypeScript
- 严格模式，禁止 any
- 使用 interface 定义对象类型
- 函数必须声明返回类型
### React
- 只使用函数组件 + Hooks
- 状态管理使用 Zustand
- 表单使用 React Hook Form + Zod
### 命名规范
- 组件：PascalCase（UserProfile.tsx）
- 函数/变量：camelCase（getUserById）
- 常量：UPPER_SNAKE_CASE（MAX_RETRY）
- CSS 类：kebab-case（user-profile）
## 目录结构
taskflow/
├── client/ # 前端
│   └── src/
│       ├── components/ # 通用组件
│       ├── features/ # 功能模块
│       ├── hooks/ # 自定义 Hooks
│       ├── stores/ # Zustand stores
│       └── types/ # 类型定义
├── server/ # 后端
│   └── src/
│       ├── controllers/ # 控制器
│       ├── services/ # 业务逻辑
│       ├── middlewares/ # 中间件
│       └── routes/ # 路由
├── prisma/ # 数据库
└── e2e/ # E2E 测试
## Git 规范
### 分支策略
- main：生产环境
- develop：开发环境
- feature/*：功能开发
- fix/*：Bug 修复
### 提交格式
<type>(<scope>): <subject>
type: feat | fix | docs | style | refactor | test | chore
示例：`feat(task): add task creation API`
## 重要提醒
**IMPORTANT**:
- 所有 API 请求必须通过 `client/src/lib/api.ts` 封装
- 数据库操作只能通过 Prisma，不要写原生 SQL
- 前端环境变量必须以 `VITE_` 开头
**NEVER**:
- 不要在代码中硬编码密钥或密码
- 不要直接修改 node_modules
- 不要跳过 TypeScript 类型检查
## 常见问题
### 依赖安装失败
rm -rf node_modules pnpm-lock.yaml pnpm install
### 数据库连接失败
检查 `.env` 中的 `DATABASE_URL`，确保 PostgreSQL 已启动。
### 类型错误
运行 `pnpm typecheck` 查看详细错误信息。

# AGENTS.md
## Project: TaskFlow
A full-stack task management application using React + Node.js monorepo.
## Quick Start
- Install: `pnpm install`
- Dev: `pnpm dev`
- Test: `pnpm test`
- Build: `pnpm build`
- Lint: `pnpm lint`
## Tech Stack
- Frontend: React 18, TypeScript, Vite, TailwindCSS, Zustand
- Backend: Node.js, Express, TypeScript
- Database: PostgreSQL, Prisma
- Testing: Jest, React Testing Library
## Code Style
### TypeScript
- Strict mode, no `any`
- Use `interface` for objects
- Explicit return types
### React
- Functional components only
- Zustand for state
- React Hook Form + Zod for forms
### Naming
- Components: PascalCase
- Functions: camelCase
- Constants: UPPER_SNAKE_CASE
## Structure
client/src/
├── components/ # Shared UI
├── features/ # Feature modules
├── hooks/ # Custom hooks
├── stores/ # State management
└── types/ # TypeScript types
server/src/
├── controllers/ # Request handlers
├── services/ # Business logic
├── middlewares/ # Express middleware
└── routes/ # API routes
## Testing
- Run `pnpm test` before commit
- Coverage target: 80%
- E2E tests in `e2e/` directory
## PR Guidelines
- Format: `<type>(<scope>): <description>`
- Types: feat, fix, docs, style, refactor, test, chore
- Link issues: `Closes #123`
- Require 1 approval
## Security
- No hardcoded secrets
- Use env variables
- Sanitize user input

# Frontend AGENTS.md
## Overview
React frontend for TaskFlow application.
## Commands
- Dev: `pnpm dev:client`
- Test: `pnpm test:client`
- Build: `pnpm build:client`
## Component Guidelines
- Use TailwindCSS for styling
- Prefer composition over inheritance
- Extract reusable logic to hooks
- Keep components under 200 lines
## State Management
- Local state: useState/useReducer
- Global state: Zustand stores in `stores/`
- Server state: React Query
## File Naming
- Components: `ComponentName.tsx`
- Hooks: `useHookName.ts`
- Utils: `utilName.ts`
- Types: `types.ts` or `ComponentName.types.ts`

# Backend AGENTS.md
## Overview
Express.js backend API for TaskFlow.
## Commands
- Dev: `pnpm dev:server`
- Test: `pnpm test:server`
- Build: `pnpm build:server`
## API Design
- RESTful conventions
- Base path: `/api/v1`
- Response: `{ code, data, message }`
## Error Handling
- Use custom error classes
- Centralized error middleware
- Log errors with context
## Database
- All queries through Prisma
- Use transactions for multi-step operations
- Index frequently queried columns
## Authentication
- JWT tokens in Authorization header
- Refresh token rotation
- Rate limiting on auth endpoints

# 本地配置
## 我的开发环境
- Node.js: v20.10.0
- pnpm: 8.15.0
- IDE: VS Code
## 个人偏好
- 使用 Vim 键位
- 终端使用 iTerm2 + zsh
- 调试时优先使用 console.log
## 本地数据库
- Host: localhost
- Port: 5432
- Database: taskflow_dev

# .gitignore
CLAUDE.local.md

claude
> 请帮我创建一个新的 Task 组件

# 不好的写法
我们的代码风格比较严格，请注意保持一致性。

# 好的写法
## 代码风格
- 使用 2 空格缩进
- 字符串使用单引号
- 行尾不加分号
- 运行 `pnpm lint` 检查

## 关键规则
**CRITICAL**: 所有数据库迁移必须经过 review
**IMPORTANT**: API 响应必须包含错误码
**MUST**: 提交前必须通过所有测试
**NEVER**: 永远不要在日志中打印敏感信息
**ALWAYS**: 总是使用参数化查询防止 SQL 注入

# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm lint
      - run: pnpm typecheck
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm test

# [PROJECT_NAME] Frontend
## Tech Stack
- Framework: React/Vue/Svelte
- Language: TypeScript
- Styling: TailwindCSS/CSS Modules
- State: Zustand/Pinia/Redux
## Commands
- `pnpm dev` - Start dev server
- `pnpm build` - Production build
- `pnpm test` - Run tests
- `pnpm lint` - Lint code
## Code Style
[团队前端规范]
## Testing
[测试要求]

# [PROJECT_NAME] Backend
## Tech Stack
- Runtime: Node.js/Go/Python
- Framework: Express/Gin/FastAPI
- Database: PostgreSQL/MySQL/MongoDB
- ORM: Prisma/GORM/SQLAlchemy
## Commands
- `pnpm dev` - Start dev server
- `pnpm build` - Build for production
- `pnpm test` - Run tests
- `pnpm db:migrate` - Run migrations
## API Design
[API 设计规范]
## Security
[安全要求]

场景	建议
只用 Claude Code	使用 CLAUDE.md
只用 Cursor/Copilot	使用 AGENTS.md
团队使用多种工具	同时维护两个文件
开源项目	优先使用 AGENTS.md（更通用）

CLAUDE.md 与 AGENTS.md 配置文件完全指南

CLAUDE.md 与 AGENTS.md 配置文件完全指南

1. 为什么需要这两个文件

1.1 两个文件的定位

1.2 传统 README.md vs AI 配置文件

2. CLAUDE.md 深度解析

2.1 什么是 CLAUDE.md

2.2 文件位置与优先级

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

2.3 CLAUDE.md 应该包含什么

2.3.1 常用命令

2.3.2 代码风格指南

2.3.3 项目架构说明

2.3.4 开发规范和注意事项

2.4 CLAUDE.md 完整示例

2.5 创建 CLAUDE.md 的方法

2.6 CLAUDE.md 优化技巧

3. AGENTS.md 深度解析

3.1 什么是 AGENTS.md

3.2 AGENTS.md vs CLAUDE.md

3.3 AGENTS.md 的优先级机制

3.4 AGENTS.md 应该包含什么

3.4.1 项目概述

3.4.2 构建和测试命令

3.4.3 代码风格和规范

3.4.4 测试说明

3.4.5 PR 和提交规范

3.5 AGENTS.md 完整示例

3.6 配置特定工具识别 AGENTS.md

3.7 从 AGENT.md 迁移到 AGENTS.md

4. 实践案例：从零配置新项目

4.1 项目背景

4.2 创建项目结构

4.3 配置 CLAUDE.md

4.4 配置 AGENTS.md

4.5 配置子目录的 AGENTS.md

4.6 配置本地私有设置

4.7 验证配置效果

5. 最佳实践与进阶技巧

5.1 内容组织原则

5.2 优先级和强调

5.3 团队协作策略

5.4 常见问题解决

5.5 与 CI/CD 集成

5.6 配置文件模板

6. 总结

6.1 核心要点回顾

6.2 选择建议

6.3 未来展望

参考资料

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具