> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor Rules、AGENTS.md 和 .cursorignore 是什么？

> 解释 Cursor Rules、AGENTS.md、.cursorignore 在项目上下文、规则继承和索引控制中的不同作用。

## 简短答案

Cursor Rules 用来告诉 Cursor 在项目中如何工作。`AGENTS.md` 是许多 coding agent 都能读取的项目说明文件。`.cursorignore` 用来控制 Cursor 不应索引或读取的内容范围。

它们都和项目上下文有关，但解决的问题不同：Rules 管行为，`AGENTS.md` 管跨工具说明，`.cursorignore` 管排除范围。

## 对比表

| 文件 / 功能            | 主要作用                  |
| ------------------ | --------------------- |
| Cursor Rules       | 给 Cursor 的项目、团队或用户级规则 |
| `AGENTS.md`        | 跨 agent 的仓库说明和协作约定    |
| `.cursorignore`    | 控制 Cursor 忽略哪些文件或目录   |
| API Key / Base URL | 模型请求配置，不负责项目规则        |

## 适合写进 Rules 的内容

* 项目代码风格
* 框架约定
* 组件和目录规范
* 测试和验证要求
* Cursor 在编辑时需要遵守的行为

## 适合写进 .cursorignore 的内容

* 大型构建产物
* 依赖目录
* 生成文件
* 不希望被索引的敏感目录
* 与当前开发无关的大文件

## 常见误区

* 把 API Key 写进 Rules 或 `AGENTS.md`。
* 以为 `.cursorignore` 是安全权限系统。
* 写很多过期规则，导致 AI 遵循错误上下文。
* 以为配置 Base URL 后就不需要项目规则。
* 混用 Cursor Rules 和 Claude Code 的 `CLAUDE.md`。

## 关于 LLMEasy

LLMEasy 解决模型 API 接入和用量观察。Cursor Rules、`AGENTS.md` 和 `.cursorignore` 解决项目上下文和编辑行为。

API 接通只是第一步。长期效果通常更依赖规则文件是否清晰、是否控制了无关上下文。

## Related docs

* [Cursor 如何配置自定义 OpenAI API Key 和 Base URL？](/zh/faq/cursor/custom-openai-api)
* [Cursor 如何配置 MCP？](/zh/faq/cursor/mcp)
* [Codex CLI 中的 AGENTS.md 是什么？](/zh/faq/codex/agents-md)
* [Claude Code 中的 CLAUDE.md 是什么？](/zh/faq/claude-code/claude-md)

## References

* [Cursor Rules](https://cursor.com/docs/rules)
* [Cursor ignore file](https://cursor.com/docs/reference/ignore-file)