---
title: "AGENTS.md: 경로 및 형식 · DotsAgent"
description: "AGENTS.md의 위치와 형식, frontmatter, 전역 및 중첩 파일의 병합 방식, 이 파일을 읽는 도구를 확인하세요. 2026-10-01에 확인했습니다."
url: https://dotsagent.io/ko/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: 파일 위치와 도구별 읽기 방식

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

## 파일 위치

- 저장소 루트의 AGENTS.md: 프로젝트 전체에 적용됩니다.
- 하위 디렉터리나 패키지에 있는 AGENTS.md: 에이전트는 디렉터리 트리에서 가장 가까운 파일을 사용합니다.
- OpenAI Codex: 전역 파일 ~/.codex/AGENTS.override.md를 사용합니다. 이 파일이 비어 있거나 없으면 ~/.codex/AGENTS.md를 사용합니다.
- Cline: 전역 파일 ~/.agents/AGENTS.md를 사용합니다.
- Claude Code는 .claude/AGENTS.md도 지원합니다.

## 형식

frontmatter나 필수 필드가 없는 일반 Markdown 형식입니다. 제목은 자유롭게 사용할 수 있습니다. 형식 자체에는 크기 제한이 없지만, OpenAI Codex는 기본값인 32 KiB의 project_doc_max_bytes에 도달하면 읽기를 중단합니다.

`AGENTS.md`

```
# Acme web app

Customer-facing web app with an admin area and a REST API.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`

## Code style

- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.

## Never

- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
```

## 우선순위 및 병합

편집 중인 파일과 가장 가까운 AGENTS.md가 우선하며, 채팅에서 명시한 지침은 모든 파일보다 우선합니다. OpenAI Codex는 프로젝트 루트부터 작업 디렉터리까지 각 디렉터리에서 파일 하나씩을 이어 붙이므로, 가까운 파일이 뒤에 와서 우선 적용됩니다. CLAUDE.md가 있으면 Claude Code는 기본적으로 AGENTS.md를 무시합니다.

## 이 파일을 읽는 도구

| 도구 | 지원 |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | 기본 지원. 전역 파일을 읽은 다음 루트부터 작업 디렉터리까지 각 디렉터리에서 파일을 최대 하나씩 읽으며, 기본 한도는 32 KiB입니다. |
| [Claude Code](https://code.claude.com/docs/en/memory) | v2.1.277부터 기본 지원합니다. 다만 claude-md-and-agents-md로 설정하지 않는 한 CLAUDE.md나 CLAUDE.local.md가 없어야 합니다. |
| [Cursor](https://cursor.com/docs/context/rules) | 기본 지원. 루트와 하위 디렉터리의 파일을 읽으며, 하위 파일은 상위 파일과 결합되고 더 구체적인 파일이 우선합니다. |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | 기본 지원. 저장소 내 어디에 있든 가장 가까운 파일이 우선합니다. |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | 기본 지원. 루트 파일은 항상 적용되며, 하위 디렉터리의 파일은 해당 디렉터리에 적용됩니다. |
| [Cline](https://docs.cline.bot/features/cline-rules) | 기본 지원하며 전역 파일 ~/.agents/AGENTS.md도 사용할 수 있습니다. Rules 패널에서 켜거나 끌 수 있습니다. |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | 선택 지원: .gemini/settings.json의 context.fileName에 AGENTS.md를 추가하세요. |
| [Aider](https://agents.md/) | 선택 지원: .aider.conf.yml에 read: AGENTS.md를 추가하세요. |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | 에이전트 작업 공간에서 필수 운영 지침 파일로 기본 지원합니다. |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | agents.md 목록에 있는 23개 도구 중 하나입니다. Amp, Jules, Zed, Warp, goose, opencode, JetBrains Junie 등이 포함되며, 각 도구를 하나씩 확인하지는 않았습니다. |

## 팁

- 기존 AGENT.md의 이름을 바꾸나요? agents.md에서는 두 이름을 모두 사용할 수 있도록 mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md를 제안합니다.
- 테스트 및 린트 명령을 적어 두세요. 에이전트는 명령을 찾아 실행하고, 완료 전에 실패를 수정하려고 합니다.
- 모노레포에서는 루트 파일 하나를 길게 늘리는 대신 패키지마다 짧은 AGENTS.md를 추가하세요.
- OpenAI Codex에서는 같은 디렉터리의 AGENTS.override.md가 AGENTS.md보다 우선합니다.

양식 하나로 다섯 가지 도구에 사용할 AGENTS.md와 규칙 파일을 생성하세요. [AGENTS.md 생성기 열기 →](https://dotsagent.io/ko/instructions)

## 기타 지침 파일

[CLAUDE.md](https://dotsagent.io/ko/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/ko/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/ko/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/ko/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/ko/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/ko/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/ko/instructions/files/openclaw-workspace)

## 출처

1. [agents.md](https://agents.md/)/
2. [github.com](https://github.com/agentsmd/agents.md)/agentsmd/agents.md
3. [linuxfoundation.org](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation)/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foun
4. [openai.com](https://openai.com/index/agentic-ai-foundation/)/index/agentic-ai-foundation/
5. [developers.openai.com](https://developers.openai.com/codex/guides/agents-md)/codex/guides/agents-md

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

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