---
title: "에이전트 지침 파일: AGENTS.md, CLAUDE.md 등 · DotsAgent"
description: "AGENTS.md, CLAUDE.md, GEMINI.md와 Cursor, Copilot, Devin, Cline의 규칙 파일 위치와 병합 방식, AGENTS.md를 읽는 9개 코딩 도구를 알아보세요."
url: https://dotsagent.io/ko/instructions/files
---

지침 · 레퍼런스

# 에이전트 지침 파일

모든 코딩 에이전트는 작업을 시작하기 전에 프로젝트의 상시 지침 파일을 불러옵니다. 각 도구가 파일을 찾는 위치, 인식하는 frontmatter, 전역·프로젝트·중첩 파일의 병합 방식을 정리했습니다. 2026-10-01 기준으로 각 업체의 문서를 확인했습니다.

## 도구별로 읽는 파일

| 도구 | 읽는 파일 | AGENTS.md |
| --- | --- | --- |
| OpenAI Codex | `AGENTS.md``AGENTS.override.md``~/.codex/AGENTS.md` | 기본 지원 |
| Claude Code | `CLAUDE.md``CLAUDE.local.md``.claude/rules/*.md``~/.claude/CLAUDE.md``AGENTS.md` | 기본 지원 |
| Cursor | `.cursor/rules/*.mdc``AGENTS.md` | 기본 지원 |
| GitHub Copilot | `.github/copilot-instructions.md``.github/instructions/*.instructions.md``AGENTS.md``CLAUDE.md``GEMINI.md` | 기본 지원 |
| Gemini CLI | `GEMINI.md``~/.gemini/GEMINI.md``.gemini/settings.json` | 설정 필요 |
| Devin Desktop (구 Windsurf) | `.devin/rules/*.md``.windsurf/rules/*.md``.windsurfrules``~/.codeium/windsurf/memories/global_rules.md``AGENTS.md` | 기본 지원 |
| Cline | `.clinerules/*.md``.cline/rules/*.md``AGENTS.md``.cursorrules``.windsurfrules` | 기본 지원 |
| Aider | `.aider.conf.yml` | 설정 필요 |
| OpenClaw | `AGENTS.md``SOUL.md``IDENTITY.md``USER.md``MEMORY.md` | 기본 지원 |

AGENTS.md 하나를 단일 기준으로 유지하고 나머지 도구가 이를 참조하도록 설정하세요. 위의 9개 도구 중 7개는 별도 설정 없이 AGENTS.md를 읽습니다. Gemini CLI와 Aider에는 설정 한 줄이 필요하며, @AGENTS.md만 적은 CLAUDE.md를 두면 이전 버전의 Claude Code도 최신 지침을 따릅니다. AGENTS.md로 표현할 수 없는 경로별 규칙에만 각 도구의 자체 규칙 형식을 사용하세요.

## 모든 지침 파일

- [AGENTS.md](https://dotsagent.io/ko/instructions/files/agents-md): AGENTS.md는 대부분의 코딩 에이전트가 별도 설정 없이 읽는 일반 Markdown 형식의 프로젝트 지침 파일입니다. OpenAI는 이 파일을 Linux Foundation 산하 Agentic AI Foundation에 기여했으며, 6만 개가 넘는 오픈소스 프로젝트에서 사용합니다.

- [CLAUDE.md (Claude Code)](https://dotsagent.io/ko/instructions/files/claude-md): CLAUDE.md는 Claude Code가 시작할 때 홈 디렉터리, 프로젝트, 모든 상위 디렉터리에서 불러오는 메모리 파일입니다. .claude/rules/의 경로별 규칙은 일치하는 파일을 읽을 때만 적용되는 추가 지침을 제공합니다.

- [GEMINI.md (Gemini CLI)](https://dotsagent.io/ko/instructions/files/gemini-md): GEMINI.md는 Gemini CLI가 모든 prompt와 함께 보내는 컨텍스트 파일입니다. context.fileName을 설정하면 AGENTS.md나 다른 이름의 파일도 읽을 수 있습니다.

- [Cursor Project Rules (.cursor/rules/*.mdc)](https://dotsagent.io/ko/instructions/files/cursor-rules): Cursor Project Rules는 .cursor/rules/에 있는 .mdc 파일이며, frontmatter에서 각 규칙을 적용할 시점을 지정합니다. Cursor는 AGENTS.md도 읽으며, 저장소 외부에서 설정하는 User Rules와 Team Rules도 지원합니다.

- [GitHub Copilot custom instructions](https://dotsagent.io/ko/instructions/files/github-copilot-instructions): GitHub Copilot은 저장소 전체에 적용되는 .github/copilot-instructions.md 파일 하나와 경로별 .instructions.md 파일을 읽습니다. AGENTS.md도 따르며, 대안으로 루트에 CLAUDE.md 또는 GEMINI.md 파일 하나를 둘 수 있습니다.

- [Devin Desktop (Windsurf) rules](https://dotsagent.io/ko/instructions/files/windsurf-rules): 2026-06-02부터 Windsurf의 새 이름인 Devin Desktop은 .devin/rules/의 규칙 파일을 읽으며, .windsurf/rules/와 레거시 .windsurfrules도 계속 지원합니다. 각 규칙의 trigger에 따라 항상 적용하거나, glob으로 일치시키거나, 모델이 선택하거나, 수동으로 호출할 수 있습니다.

- [Cline Rules (.clinerules/)](https://dotsagent.io/ko/instructions/files/cline-rules): Cline Rules는 .clinerules/의 Markdown 파일로, Cline은 이를 전역 규칙 및 AGENTS.md와 함께 적용합니다. 선택 사항인 paths 프런트매터를 사용하면 규칙을 일치하는 파일에만 적용할 수 있습니다.

- [OpenClaw workspace bootstrap files](https://dotsagent.io/ko/instructions/files/openclaw-workspace): OpenClaw는 워크스페이스의 Markdown 부트스트랩 파일을 바탕으로 각 에이전트의 컨텍스트를 구성합니다. 필수 파일인 AGENTS.md가 그 중심입니다. 이 파일은 새 세션이 시작될 때마다 첫 턴의 system prompt에 삽입됩니다.

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일