CLAUDE.md랑 AGENTS.md 잘 쓴 예시 볼 수 있는 곳 있어?

CLAUDE.md랑 AGENTS.md 잘 쓴 예시 볼 수 있는 곳 있어?

agents.md의 공식 샘플과 Anthropic·OpenAI 공식 문서부터 보세요. 실제 저장소의 CLAUDE.md와 AGENTS.md도 아래에서 바로 열 수 있습니다.

다만 잘 썼다는 파일을 통째로 붙여 넣으면 내 프로젝트에 없는 명령어까지 따라옵니다. 예시는 어떤 내용을 적는지 배우는 데 쓰고, 실행할 명령과 건드릴 파일은 자기 환경에 맞게 확인해야 합니다. 아래 링크와 화면은 2026년 11월 15일에 확인했습니다.

CLAUDE.md·AGENTS.md 예시는 어디부터 보면 되나요?

첫 파일의 틀은 agents.md, Claude Code 작성법은 Anthropic 문서, Codex의 적용 위치는 OpenAI 문서에서 확인하면 됩니다. 실제 운영 중인 파일이 궁금할 때는 아래 두 GitHub 원본을 이어서 보세요.

공식 샘플과 실제 저장소는 쓰임이 다릅니다. 샘플은 시작하기 쉽게 정리되어 있고, 실제 파일에는 그 프로젝트에서 지켜야 할 구체적인 사정이 담겨 있습니다.

Anthropic의 실제 CLAUDE.md는 GitHub Actions에서 유지할 실행 환경과 검사 파일을 구체적으로 지정합니다

Anthropic 공개 저장소의 GitHub Actions 지침을 직접 캡처했습니다. 출처: claude-code/CLAUDE.md, 조회 2026-11-15.

볼 곳 열면 볼 수 있는 것 이 부분을 참고하세요 그대로 옮기기 전에 확인할 것
agents.md 공식 샘플 설치·실행·테스트·코드 스타일을 적은 짧은 예와 긴 예 처음 만드는 파일의 구성 pnpm과 프로젝트 이름이 내 환경에서도 맞는지
Anthropic의 메모리·지침 문서 CLAUDE.md 작성법, 파일 위치, AGENTS.md 공유 방법 무엇을 적고 어디에 둘지 사용 버전과 Project instructions 설정
OpenAI의 AGENTS.md 안내 전역·저장소·하위 폴더 지침을 나누는 예 서로 다른 폴더에 다른 규칙을 적용하는 방식 현재 작업 폴더와 override 파일 유무
Anthropic Claude Code의 실제 CLAUDE.md GitHub Actions 실행 환경을 유지하는 지침 바꾸면 안 되는 조건과 검사 파일을 함께 적는 방식 그 저장소 전용 runner와 권한 정책
OpenAI Agents Python SDK의 실제 AGENTS.md 작업별 규칙과 테스트·검증 문서 연결 짧은 지침에서 자세한 절차로 연결하는 방식 SDK 전용 명령어·스킬·폴더가 내 프로젝트에도 있는지

다른 언어의 예시를 더 찾으려면 검색창에 AGENTS.md examples site:agents.md 또는 CLAUDE.md AGENTS.md examples github를 넣어 보세요. Claude 쪽 공식 자료를 찾을 때는 CLAUDE.md best practices site:anthropic.com, 실제 Anthropic 저장소를 찾을 때는 CLAUDE.md site:github.com/anthropics로 범위를 좁힐 수 있습니다. 검색 결과에서는 소개 글을 거쳐도 원본 파일을 마지막에 직접 여는 것까지 하세요.

실제 파일에서 무엇을 보면 잘 썼는지 알 수 있나요?

AI가 다음 행동을 정할 수 있는지 보세요. 어느 폴더에서 무슨 명령을 실행하고, 무엇을 바꾸기 전에 확인하며, 끝나면 어떤 결과를 검사하는지가 구체적이어야 합니다.

Anthropic의 실제 CLAUDE.md는 GitHub Actions에서 지킬 조건에 집중합니다. 실행 환경을 마음대로 바꾸지 말라는 지침과 검사 파일 위치를 함께 적어 둡니다. 여기서 가져올 것은 조건을 구체적으로 적는 방식입니다. 파일에 나온 실행 환경을 자기 앱에 그대로 설치할 이유는 없습니다.

OpenAI의 SDK 파일은 테스트 항목에서 uv run python과 make sync를 안내하고, 자세한 명령은 tests/README.md와 Makefile로 연결합니다. 지침 파일 하나에 설명을 끝없이 넣기보다, 에이전트가 다음에 볼 문서를 찾게 해 줍니다.

반대로 “좋은 코드를 작성하라”, “테스트를 충분히 하라”만 있으면 실제 행동을 고르기 어렵습니다. 자기 프로젝트에서 확인한 테스트 명령, 수정 대상 폴더, 완료 후 확인할 화면을 적어야 도움이 됩니다. Anthropic 공식 문서도 구체적인 지침과 모순 없는 구성을 권합니다.

공개 저장소의 파일은 계속 바뀝니다. 이 글은 파일 구조를 읽고 비교한 결과이며, 두 제품의 실행 성능을 비교한 실험은 아닙니다. 예시를 팀 문서에 남긴다면 확인 날짜와 원본 링크도 같이 적어 두세요.

내 서비스에 어떻게 적용할까요? VUILD는 이렇게 안내합니다

예시 파일만 필요한 분이라면 위 공개 자료로 시작할 수 있습니다. VUILD가 맞는 경우는 만들고 싶은 서비스가 있고, 그 아이디어를 어떤 화면과 기능으로 만들어야 할지부터 막혔을 때입니다.

VUILD 공식 안내는 문제와 사용자 정의, 화면과 기능 설계, 핵심 기능 구현, 배포까지의 흐름을 보여 줍니다. 입력은 만들고 싶은 서비스 아이디어이고, 안내하는 목표는 실제로 열어 볼 수 있는 서비스 URL입니다. 파일을 채우는 일도 이 과정에서 무엇을 만들고 어떻게 확인할지 정한 뒤에 해야 합니다.

현재 공개 안내에는 무료 온라인 강의 52편, 6시간 아이디어에서 URL까지의 실습, 1:1 실시간 멘토 지원이 나와 있습니다. Windows와 Mac 모두 가능하고 선수과정이 없다고 안내합니다. 이는 공식 페이지에 적힌 과정 설명이며, 준비 정도와 무관하게 같은 결과가 나온다는 보장은 아닙니다.

혼자 학습할 순서를 찾거나 구현까지 해 보고 싶은 분에게 맞습니다. 반면 특정 저장소의 규칙 파일 교정만 원하는 분은 먼저 공식 문서와 프로젝트 유지관리자의 안내를 확인하세요. VUILD가 그 파일을 대신 교정해 주는 상품이라고 약속하지는 않습니다.

내 아이디어를 어떤 순서로 만들어야 할지 막혔다면 VUILD 무료 강의와 실습 경로 확인하기에서 먼저 볼 과정을 골라 보세요. 공식 페이지에서 무료 학습과 하루 실습 경로를 확인할 수 있습니다.

남의 예시를 내 프로젝트로 바꿀 때 무엇을 확인하나요?

예시 옆에 자기 프로젝트를 열어 놓고 아래 표를 채워 보세요. 확인하지 못한 명령을 완성된 지침처럼 적지 않는 것부터 시작하면 됩니다.

SDK의 테스트 부분도 실행 명령과 자세한 설명의 위치를 함께 적습니다. 자기 파일을 만들 때도 같은 질문을 던질 수 있습니다. “이 명령을 어디에서 실행하고, 실패하면 어느 문서를 보나?”

OpenAI SDK의 AGENTS.md는 Python 실행 방법과 상세 테스트 문서 위치를 함께 안내합니다

OpenAI 공개 SDK의 테스트 지침 부분을 직접 캡처했습니다. 출처: openai-agents-python/AGENTS.md, 조회 2026-11-15.

확인할 항목 내 프로젝트에 적을 내용
프로젝트 목적 누구의 어떤 일을 돕는 앱인지 한 문장
작업 폴더 명령을 실행할 기준 폴더
설치 실제로 확인한 의존성 설치 명령
실행 개발 화면을 여는 명령과 확인할 주소
테스트 이번 수정에 필요한 검사 명령
수정 범위 이번에 고칠 소스 폴더와 참고 문서
생성 파일 직접 고치지 않을 파일과 다시 만드는 방법
승인 배포·외부 발송처럼 먼저 확인할 작업
완료 확인 열어 볼 화면이나 통과해야 할 결과
유지관리 확인 날짜와 자세한 설명이 있는 문서

아래는 이 글에서 만든 작성 틀입니다. 대괄호를 채우기 전에는 실행용 파일로 쓰지 마세요. 설치 명령을 모르면 AI에게 프로젝트의 설정 파일을 읽고 후보를 찾게 한 뒤, 직접 확인한 값을 적으면 됩니다.

## 이 프로젝트
- [누구의 어떤 일을 돕는 서비스인지]

## 실행과 확인
- 기준 폴더: [실제 경로]
- 설치 명령: [확인한 명령]
- 실행 명령: [확인한 명령]
- 수정 후 검사: [검사 명령과 확인할 결과]

## 작업 범위
- 수정할 소스: [폴더]
- 직접 수정하지 않을 생성 파일: [파일]
- 배포 전에는 [담당자]에게 확인받는다.
- 상세 절차: [저장소 안의 문서 경로]

작은 프로젝트라면 필요한 항목부터 남기세요. 없는 테스트나 배포 절차를 만들었다고 적을 필요는 없습니다. 아직 확인하지 못한 항목은 확인할 일로 분리하고, 확인한 뒤 지침에 넣으면 됩니다.

파일을 만들었는데 적용되지 않으면 어떻게 하나요?

문장을 더 넣기 전에 파일 위치와 현재 설정부터 확인하세요. 같은 이름의 파일이 여러 폴더에 있으면 내가 고친 파일과 도구가 읽은 파일이 다를 수 있습니다.

Codex는 공식 안내에 따라 전역 지침과 프로젝트 루트부터 현재 작업 폴더까지의 지침을 모읍니다. 하위 폴더의 override도 확인해야 합니다. 실제 적용 순서는 OpenAI의 지침 파일 안내에서 확인할 수 있습니다.

Claude Code는 AGENTS.md도 읽나요?

현재 공식 문서는 설정에 따라 직접 읽는 경우를 안내합니다. 기본 설정에서는 CLAUDE.md·CLAUDE.local.md 유무가 영향을 주며, 버전에 따라 지원 여부도 달라집니다. “항상 읽는다”로 단정하지 말고 Anthropic의 AGENTS.md 안내에서 자기 버전과 Project instructions 설정을 확인하세요.

두 파일에 같은 규칙을 계속 복사해야 하나요?

공통 규칙을 한 곳에 두고 연결하는 방법을 쓸 수 있습니다. Anthropic 문서에는 CLAUDE.md에서 @AGENTS.md로 가져오는 예가 있습니다. 복사본을 따로 고치다 규칙이 달라지지 않도록, 어느 파일을 원본으로 관리할지 먼저 정하세요.

예시가 길수록 더 잘 작동하나요?

길이만으로 판단하기 어렵습니다. 실제 명령과 경계가 맞는지, 서로 모순되는 지침이 없는지부터 확인하세요. 한 작업에만 필요한 긴 절차는 별도 문서로 옮기고 지침에서 연결할 수 있습니다.

지금 파일이 없다면 공식 샘플로 틀을 만드세요. 이미 파일이 있다면 위 표에서 실행·검사 명령부터 확인하면 됩니다. 아이디어를 실제 서비스로 만드는 순서가 막혔다면 VUILD에서 무료 강의와 실습 안내 열기로 이어 가세요. 자기 서비스에서 무엇부터 만들어야 할지 확인하는 데 쓸 수 있습니다.

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Claude Code는 AGENTS.md도 읽나요?","acceptedAnswer":{"@type":"Answer","text":"현재 공식 문서는 설정에 따라 직접 읽는 경우를 안내합니다. CLAUDE.md·CLAUDE.local.md 유무, 설치 버전, Project instructions 설정을 공식 문서에서 확인하세요."}},{"@type":"Question","name":"두 파일에 같은 규칙을 계속 복사해야 하나요?","acceptedAnswer":{"@type":"Answer","text":"공통 규칙을 한 곳에 두고 연결하는 방법을 쓸 수 있습니다. Anthropic 문서에는 CLAUDE.md에서 @AGENTS.md로 가져오는 예가 있습니다. 어느 파일을 원본으로 관리할지 먼저 정하세요."}},{"@type":"Question","name":"예시가 길수록 더 잘 작동하나요?","acceptedAnswer":{"@type":"Answer","text":"길이만으로 판단하기 어렵습니다. 실제 명령과 경계가 맞는지, 서로 모순되는 지침이 없는지부터 확인하세요. 한 작업에만 필요한 긴 절차는 별도 문서로 옮기고 연결할 수 있습니다."}}]}

커리어 방향, 전문가와 함께 설계하세요

강점 기반 진로 탐색과 커리어 전략을 CareerTech에서 시작할 수 있습니다.

댓글 0개

댓글을 남기려면 로그인하세요.

관련 글

AI에 커리어 묻기 전에 딱 3가지: 커리어 코칭 프롬프트 따라 하기
커리어

AI에 커리어 묻기 전에 딱 3가지: 커리어 코칭 프롬프트 따라 하기

AI한테 커리어를 물었는데 뻔한 답만 돌아왔다면, 묻기 전에 나를 알 재료부터 건네 보세요. AI는 내가 어떤 사람인지 모르고 답해서, «내 커리어 어떻게 하면 좋을까?» 한 줄로는 누구에게나 할 수 있는 말만 나옵니다. 9WAY 무료 진단을 받고, 결과 화면에서 커리어 코칭 프롬프트를 복사하고, 쓰던 AI에 붙인 뒤 그 밑에 해 온 일과 고민을 몇 줄 더...

Daniel ·
53
일은 다 해내는데 지친 걸 모르는 이유와 결과 말고 내 상태 점검표
커리어

일은 다 해내는데 지친 걸 모르는 이유와 결과 말고 내 상태 점검표

일은 다 해내는데 나만 지쳐 있는 것 같다면, 결과 말고 내 상태를 따로 적어 봐야 합니다. 일 잘하는 사람은 힘이 바닥나도 결과물이 평소처럼 나와서, 본인도 주변도 지친 걸 제일 늦게 알아차리거든요. 일주일에 한 번, 일을 끝냈을 때 기운이 어땠는지 · 예전에 재밌던 일이 지금도 재밌는지 · 두통이나 소화 같은 몸 상태가 어땠는지 세 가지만 짧게 적어 보...

Daniel ·
49
지메일 자동화, 클로드로 10분마다 메일 읽고 답장 초안까지 쓰는 3단계
커리어

지메일 자동화, 클로드로 10분마다 메일 읽고 답장 초안까지 쓰는 3단계

새 메일 알림이 뜰 때마다 하던 일을 멈추고 메일함부터 여시나요? 클로드에 내 지메일을 한 번 연결하고 할 일을 한 줄로 적어 두면, 10분마다 클로드가 새 메일을 읽고 광고를 거른 뒤 답장 초안까지 써서 알려 줍니다. 코딩을 해 본 적 없어도 세 단계만 따라 하면 돼요. 지메일을 연결하고, 클로드 코드에 10분마다 돌게 맡기고, 메일을 나누는 기준과 알려...

Daniel ·
66
팀원 질문에 다 답해 주는 팀장이 지치는 이유와 일 맡기는 법
커리어

팀원 질문에 다 답해 주는 팀장이 지치는 이유와 일 맡기는 법

팀원 질문에 하나하나 바로 답해 주는 팀장이 지치는 건, 팀원일 때 제일 잘해서 인정받던 일을 팀장이 돼서도 성실하게 계속하고 있어서예요. 아침에 자리에 앉자마자 팀원들이 차례로 와서 "팀장님, 이건 어떻게 해요?" 하고 묻습니다. 그때마다 하나씩 풀어 주다 보면 하루가 다 가고, 저녁 6시가 돼서야 내 보고서를 엽니다. 팀장의 힘은 문제...

Daniel ·
46