가이드
모든 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.
에이전트별 전체 규칙 가이드
- Cursor 규칙 설정: .mdc frontmatter, Team Rules, AGENTS.md
- Claude Code CLAUDE.md: 위치, import, AGENTS.md
- Codex AGENTS.md: 전역, 프로젝트, override 파일
- Gemini CLI GEMINI.md: 위치, import, /memory
- GitHub Copilot 사용자 지정 지침
- Cline Rules: 워크스페이스, 전역, 조건부 규칙
- Kiro steering 파일과 inclusion 모드
- Junie 지침과 AGENTS.md
- Amp AGENTS.md와 glob 범위 지침
- goose .goosehints와 AGENTS.md
- Zed 지침 파일, MCP, 도구 권한
- Aider CONVENTIONS.md와 .aider.conf.yml
- 복사해서 쓰는 Cursor 규칙 템플릿
- AGENTS.md 레퍼런스와 생성기
출처
이 가이드에서 확인한 공식 문서(영어)입니다. 영어판 확인일: 2026-10-18
다른 한국어 가이드
- 모든 AI 코딩 에이전트에서 모든 명령 허용하기: Cursor, Claude Code, Codex, Gemini CLI, Copilot CLI 외 7개 (2026)
- 모든 AI 코딩 에이전트의 설정 파일 위치: Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Qwen Code, Amp, Factory Droid (2026)
- 모든 AI 코딩 에이전트에 MCP server 추가하기: Claude Code, Cursor, Codex, Gemini CLI, VS Code 외 8개 (2026)
- 모든 AI 코딩 에이전트의 hook: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Kiro, Factory Droid (2026)
- 모든 AI 코딩 에이전트의 Agent Skills(SKILL.md): Claude Code, Codex, Cline, Amp, OpenHands (2026)
- Claude Code 권한: allow, ask, deny 규칙, 규칙 문법과 허용 도구
- Claude Code가 모든 명령을 실행하도록 허용하는 방법: 권한 모드, allow 규칙, 권한 건너뛰기
- Cursor가 모든 명령을 실행하도록 허용하는 방법: Run Everything, allowlist, sandbox
- Cursor 규칙 설정: 프로젝트, 사용자, Team Rules, .mdc frontmatter, glob, AGENTS.md
- Claude Code에 MCP 서버 추가(claude mcp add, .mcp.json, 스코프)
- Subagent와 커스텀 에이전트 비교: Claude Code vs Codex vs Cursor vs Gemini CLI vs GitHub Copilot (2026)