CLAUDE.md / AGENTS.md / GEMINI.md — 이름은 달라도 역할은 같아

~14 min · context-files, cross-tool, memory

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

CLAUDE.md, AGENTS.md, GEMINI.md는 이름만 다른 한 가지 패턴이야

세 파일 모두 세션 시작 때 에이전트가 읽는 Markdown 안내서고, 전역→프로젝트→하위 디렉터리 계층을 지원해. override 파일이나 대체 이름, 최대 크기 같은 세부 차이는 있지만 프로젝트 기억을 코드와 함께 버전 관리한다는 뼈대는 같아.

팀이 여러 CLI를 쓴다면 사본 셋을 따로 고치지 마. AGENTS.md 하나를 기준으로 두면 Codex는 직접 읽고 Gemini는 대체 이름으로 읽으며 Claude Code는 symlink나 짧은 CLAUDE.md로 연결할 수 있어. 단일 기준은 동기화 규칙보다 강해.

여러 CLI를 함께 쓴다면 기준 파일은 1개만 두고 나머지는 그 파일을 읽도록 연결해.

직접 확인할 항목: AGENTS.md, CLAUDE.md, contextFileName.

Code

AGENTS.md 하나를 세 가지 CLI에서 공유하기·bash

# Repo root has the canonical AGENTS.md
# Codex reads it natively. Configure the others:

# Gemini — fallback config
mkdir -p ~/.gemini
cat > ~/.gemini/settings.json <<'EOF'
{ "contextFileName": ["GEMINI.md", "AGENTS.md"] }
EOF

# Claude Code — symlink (or a tiny CLAUDE.md that says "see AGENTS.md")
ln -s AGENTS.md CLAUDE.md
# (Or write CLAUDE.md as 'See AGENTS.md for canonical project rules.')

# Now all three CLIs share the same project memory.

도구별 임시 규칙 파일·text

# Sprint-bound rules go in override files:

~/.codex/AGENTS.override.md      ← Codex temporary global override
.claude/CLAUDE.local.md          ← Claude Code local (gitignored)
~/.gemini/GEMINI.local.md        ← Gemini local (gitignored)

# Each CLI's override mechanism is slightly different but they
# all serve the same purpose: time-bounded rules that don't
# pollute the canonical files.

External links

Exercise

실제 저장소의 프로젝트 지침을 기준 파일 하나로 통합해봐. AGENTS.md가 가장 실용적인 선택이야. 다른 CLI도 그 파일을 읽도록 설정한 뒤 각각 새 세션을 열어 같은 문맥이 로드되는지 확인하고, 차이가 있다면 노트에 기록해.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousMCP — 하나로 통하는 표준 Next →권한과 sandbox, 같은 안전 다이얼로 비교하기

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.