가이드

모든 AI 코딩 에이전트의 규칙 및 지침 파일: .cursor/rules, CLAUDE.md, AGENTS.md, GEMINI.md, Copilot instructions 등 (2026)

각 AI 코딩 에이전트는 어떤 규칙 또는 지침 파일을 읽으며, AGENTS.md는 어디서나 작동합니까?

Cursor는 .cursor/rules의 .mdc 파일과 AGENTS.md를 읽습니다. Claude Code는 CLAUDE.md를 읽고, CLAUDE.md가 없으면 AGENTS.md를 대신 읽습니다. Codex, Amp, Kiro, Junie는 AGENTS.md를 기본으로 읽습니다. Gemini CLI는 GEMINI.md를 읽으며 context.fileName으로 AGENTS.md를 지정할 수 있습니다. GitHub Copilot은 .github/copilot-instructions.md, .github/instructions/*.instructions.md, AGENTS.md를 읽습니다. Cline은 .clinerules/를 읽고 .cursorrules, .windsurfrules, AGENTS.md도 감지합니다. 저장소 루트의 AGENTS.md 하나로 대부분의 에이전트를 지원할 수 있습니다.

이 페이지는 영어 가이드를 번역한 것입니다. 명령어, 설정 키, 코드는 원문 그대로이며 내용이 다를 경우 영어판을 기준으로 합니다. 영어 원문 보기 → · 다른 언어: 简体中文 · 日本語 · Español · Português (Brasil)

설정 변경 소식을 가장 먼저 받아 보세요

이 도구들의 설정, 플래그, 권한 규칙이 바뀌면 주 1회 이메일(영어)로 알려 드립니다. 모든 내용은 공식 문서로 확인합니다.

빠른 답변: 에이전트별로 읽는 파일

  • Cursor: 프로젝트 규칙은 .cursor/rules의 .mdc 파일입니다(그 안의 일반 .md 파일은 무시됨). User Rules는 Customize > Rules에 있습니다. Team Rules는 Team 및 Enterprise 플랜에서 대시보드를 통해 제공됩니다. AGENTS.md는 루트와 하위 폴더에서 작동합니다.
  • Claude Code: 팀용은 ./CLAUDE.md 또는 ./.claude/CLAUDE.md, 개인용은 ~/.claude/CLAUDE.md, 비공개 프로젝트 메모는 ./CLAUDE.local.md입니다. /init을 실행하면 생성됩니다.
  • OpenAI Codex: 전역 습관은 ~/.codex의 AGENTS.md에, 그다음 저장소 루트부터 작업 위치까지 디렉터리마다 AGENTS.md(또는 AGENTS.override.md) 하나씩.
  • Gemini CLI: 전역은 ~/.gemini/GEMINI.md, 프로젝트는 GEMINI.md. /memory show로 로드된 내용을 출력합니다.
  • GitHub Copilot: 저장소 전체는 .github/copilot-instructions.md, 일부 파일은 applyTo glob이 있는 .github/instructions/NAME.instructions.md, 그리고 저장소 어디에나 둘 수 있는 AGENTS.md.
  • Cline: 프로젝트의 .clinerules/ 또는 .cline/rules/에 있는 markdown 파일, 전역 규칙은 ~/Documents/Cline/Rules.
  • Kiro: .kiro/steering/(워크스페이스) 또는 ~/.kiro/steering/(전역)의 markdown steering 파일, 그리고 AGENTS.md.
  • Junie: .junie/AGENTS.md, 그다음 루트 AGENTS.md, 그다음 레거시 .junie/guidelines.md. 전역 지침은 ~/.junie/AGENTS.md에 둡니다.
  • Amp: 작업 디렉터리와 상위 디렉터리의 AGENTS.md, 그리고 ~/.config/amp/AGENTS.md.
  • goose: AGENTS.md와 .goosehints. 전역은 ~/.config/goose/.goosehints, 또는 프로젝트별로 둡니다.
  • Zed: 개인용은 ~/.config/zed/AGENTS.md, 그다음 .rules, .cursorrules, .windsurfrules로 시작하고 AGENTS.md와 CLAUDE.md를 포함하는 목록에서 처음 찾은 프로젝트 파일.
  • Aider: 전용 파일이 없습니다. CONVENTIONS.md를 작성하고 aider --read CONVENTIONS.md 또는 .aider.conf.yml의 read:로 로드합니다.

AGENTS.md는 어디서나 작동합니까?

거의 그렇습니다. Cursor, Codex, GitHub Copilot, Cline, Kiro, Junie, Amp, goose, Zed는 추가 설정 없이 AGENTS.md를 읽습니다. Claude Code는 저장소에 CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다. 둘 다 유지한다면 CLAUDE.md 안에 @AGENTS.md를 추가해 Claude Code가 가져오도록 하십시오. Gemini CLI는 settings.json에 context.fileName이 필요합니다.

AGENTS.md를 재사용하는 CLAUDE.md

@AGENTS.md

## Claude Code only
- Use plan mode for changes that touch more than three files.

Gemini CLI: .gemini/settings.json

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

.cursorrules는 어떻게 됩니까?

Cursor의 현재 규칙 문서는 .cursor/rules .mdc 파일, User Rules, Team Rules, AGENTS.md를 설명합니다. 루트 .cursorrules 파일은 문서화되어 있지 않습니다. 다른 도구는 여전히 이 파일명을 읽습니다. Cline은 .cursorrules를 자동으로 감지하고, Zed는 프로젝트 지침 파일 목록에서 .cursorrules를 두 번째로 확인합니다. 새 프로젝트에서는 공유 지침을 AGENTS.md에, Cursor 전용 범위 지정은 .cursor/rules에 두십시오.

규칙을 일부 파일에만 적용하기

  • Cursor: .mdc frontmatter의 globs와 alwaysApply: false.
  • Claude Code: .claude/rules/ 아래 markdown 파일의 paths 필드.
  • GitHub Copilot: .instructions.md 파일 frontmatter의 applyTo.
  • Cline: YAML frontmatter의 paths 목록.
  • Kiro: fileMatchPattern과 함께 inclusion: fileMatch.
  • Amp: AGENTS.md에서 @-mention한 파일 front matter의 globs.
  • Codex: 다른 규칙이 필요한 하위 폴더에 AGENTS.md 또는 AGENTS.override.md를 둡니다.

.cursor/rules/components.mdc

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports

.github/instructions/python.instructions.md

---
applyTo: "**/*.py"
---

Use type hints on every public function.

에이전트별 전체 규칙 가이드

출처

이 가이드에서 확인한 공식 문서(영어)입니다. 영어판 확인일: 2026-10-18

다른 한국어 가이드