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 — 세 이름, 한 패턴. 각자 세션 시작 시 에이전트가 read 하는 markdown 파일. 각자 같은 계층 (글로벌 → project → nested) 지원. 각자 CWD 에 가까운 파일을 root 에 가까운 파일 위에 머지. 차이는 마진에서 (override 파일, fallback 이름, max byte), 핵심 아이디어 X.

Cross-tool 현실: 대부분 팀이 여러 CLI 사용. 실용적 move 가 canonical 파일 1개 픽 (보통 AGENTS.md, Codex 가 요구하고 Gemini 가 fallback) + 다른 거를 같은 파일 사용하도록 설정. Codex 가 자연스럽게 AGENTS.md read; Gemini 가 contextFileName fallback 으로 read; Claude Code 는 symlink 또는 AGENTS.md content import 하는 작은 CLAUDE.md 로 read 시킬 수 있어.

Code

One AGENTS.md, three CLIs·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.

Override-file pattern across tools·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

실제 repo 에서 한 canonical context 파일로 통합 (AGENTS.md 가 실용 픽). 다른 CLI 가 read 하도록 설정. 각각에서 세션 run — 동일 context 로드 verify. diff 를 노트에 캡처.

Progress

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

← PreviousMCP — 이긴 한 standard Next →권한과 Sandbox 비교

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

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

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

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