교육 문의커뮤니티 입장하기

클로드 코드 AGENTS.md 공식 지원(v2.1.277): 읽는 조건과 읽지 않는 조건 정리

AGENTS.md는 여러 AI 코딩 도구가 함께 읽는 프로젝트 지침 파일입니다. Claude Code의 기본 선택 조건과 버전별 차이, 기존 규칙을 지우지 않고 클로드가 읽은 파일을 확인하는 순서를 정리했습니다.

게시 수정 약 28분
지금까지 100명 넘게 읽었어요, 61%가 끝까지 읽었어요
#AI#바이브코딩#자동화
Share
클로드 코드 AGENTS.md 공식 지원(v2.1.277): 읽는 조건과 읽지 않는 조건 정리 대표 이미지
준이아빠AI가 일하는 법AI 친구들의 작업실 구경하기 ↗
목차
  1. AGENTS.md 공식 지원 발표 내용 한눈에 보기
  2. 클로드 코드가 AGENTS.md를 읽는 조건
  3. 상위 폴더의 CLAUDE.md 하나 때문에 팀의 AGENTS.md가 올라오지 않는 구조
  4. Project instructions 설정값 네 가지
  5. AGENTS.md로 읽을 때 CLAUDE.md와 달라지는 곳
  6. 설정 항목이 없거나 파일이 읽히지 않을 때
  7. 1년 넘게 쌓인 요청과 공개 직후 반응
  8. 쓰던 우회법을 정리하는 방법
  9. 클로드가 AGENTS.md를 읽었는지 확인하는 순서
  10. 자주 묻는 질문
  11. Sources
  12. 3줄 요약

세 줄로 먼저 읽기

  1. Claude Code는 2026년 9월 18일 배포된 v2.1.277부터 AGENTS.md를 직접 읽지만, 기본 설정에서는 작업 폴더와 상위 폴더에 CLAUDE.md 계열 파일이 있으면 AGENTS.md를 읽지 않습니다.
  2. 두 파일을 함께 읽게 하려면 CLAUDE.md에 @AGENTS.md를 넣거나 사용자 설정에서 Project instructions를 claude-md-and-agents-md로 바꾸고, 이 값을 프로젝트 폴더의 설정 파일에 적으면 무시됩니다.
  3. 직접 읽은 AGENTS.md는 v2.1.280부터 /memory 목록에 표시되지만 InstructionsLoaded 훅은 실행되지 않으며, v2.1.281 이전 버전은 베드록 같은 제3자 제공자 환경에서 직접 로딩이 제한됩니다.

AGENTS.md는 여러 AI 코딩 도구가 함께 읽도록 만든 프로젝트 지시 파일입니다. 예를 들어 “글을 수정한 뒤 맞춤법을 확인한다”처럼 반복해서 지킬 작업 규칙을 적습니다. .md는 제목과 목록을 간단한 기호로 적는 마크다운 파일의 확장자입니다. 앤트로픽은 현지 시간 2026년 9월 18일, 한국 시간 9월 19일 새벽에 배포한 클로드 코드 v2.1.277부터 이 파일을 직접 읽기 시작했습니다.

클로드 코드를 써 본 분이라면 CLAUDE.md는 익숙할 것입니다. 프로젝트 규칙을 적어 두면 세션이 열릴 때마다 클로드가 읽어 가는 파일이고, 준이아빠블로그에서도 CLAUDE.md 세팅과 공식 문서 대조로 한 번 다뤘습니다. 코덱스나 커서, 깃허브 코파일럿을 같이 쓰는 팀은 같은 내용을 AGENTS.md에도 적어 두 벌로 관리해 왔습니다.

이번 변화로 두 벌을 한 벌로 줄일 수 있게 됐지만, 클로드가 AGENTS.md를 읽는 조건이 생각보다 까다롭습니다. 조건을 모르고 파일부터 정리하면 팀 규칙이 빠진 채로 작업이 진행됩니다. 사용 조건은 2026년 10월 4일 공식 문서 기준이고, 직접 실행한 결과는 2026년 9월 19일 v2.1.277에서 얻었습니다.

AGENTS.md 공식 지원 발표 내용 한눈에 보기

지원은 한 번에 끝나지 않고 세 버전에 걸쳐 바뀌었습니다.

AGENTS.md 지원이 바뀐 세 버전

  • v2.1.277직접 읽기 시작2026년 9월 18일 배포
  • v2.1.280/memory 목록에 표시직접 읽은 AGENTS.md
  • v2.1.281제3자 제공자 제한 완화베드록 같은 환경

제3자 제공자는 아마존 베드록처럼 앤트로픽이 아닌 회사의 클라우드를 거쳐 클로드를 쓰는 환경입니다. 나머지 동작은 아래 표에 모았습니다.

항목내용
기본 동작작업 폴더와 그 위쪽에 CLAUDE.md가 없을 때만 AGENTS.md를 대신 읽음
바꾸는 방법세션에서 /config를 열고 Project instructions 값 선택
세션 시작에 읽는 것작업 폴더와 상위 폴더의 AGENTS.md, .claude/AGENTS.md
하위 폴더클로드가 그 폴더의 파일을 열 때, 그 폴더에 CLAUDE.md가 없으면 그 폴더의 AGENTS.md를 추가로 읽음
읽지 않는 것AGENTS.local.md, AGENTS.override.md, .agents/ 아래 전부

표에서 먼저 볼 것은 기본 동작입니다. 두 파일을 합쳐 읽지 않고 CLAUDE.md가 없을 때만 AGENTS.md를 대신 읽기 때문에, 이미 CLAUDE.md를 쓰던 프로젝트에서는 아무것도 달라지지 않습니다.

그다음은 하위 폴더입니다. 세션이 열릴 때 한꺼번에 올라오는 것은 작업 폴더와 그 위쪽 파일이고, 하위 폴더의 AGENTS.md는 클로드가 그 폴더의 파일을 실제로 열 때 뒤늦게 올라옵니다. 그래서 여러 프로젝트를 한 저장소에 모은 모노레포에서는 하위 프로젝트마다 규칙을 나눠 둘 수 있습니다.

.agents/ 폴더는 다른 도구들이 스킬이나 하위 에이전트를 모아 두는 경우가 많은 곳입니다. 클로드 코드의 프로젝트 지침 자동 로딩은 이 폴더를 대상으로 삼지 않습니다. 그 안의 파일이 필요하면 클로드에게 요청해 파일 도구로 열게 합니다.

클로드 코드가 AGENTS.md를 읽는 조건

기본 설정의 클로드는 해당 경로에서 CLAUDE.md를 찾으면 AGENTS.md를 자동으로 읽지 않습니다. 공식 문서는 저장소에 있는 파일 조합을 세 가지로 나눠 설명합니다.

저장소의 파일 조합별로 클로드가 읽는 것

저장소에 있는 파일CLAUDE.mdAGENTS.md
AGENTS.md만 있고 위쪽에도 CLAUDE.md가 없음–제공
AGENTS.md와 CLAUDE.md가 함께 있음제공제공하지 않음
CLAUDE.md 안에 @AGENTS.md가 적혀 있음제공CLAUDE.md가
불러옴
기본 설정값 claude-md-or-agents-md 기준입니다.

여기서 CLAUDE.md로 세는 파일은 작업 폴더나 그 위쪽의 CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md 세 가지입니다. 개인 설정인 ~/.claude/CLAUDE.md와 회사가 배포한 관리 정책 파일, .claude/rules/ 파일은 여기에 들어가지 않고 AGENTS.md와 함께 올라옵니다.

문서만으로는 상위 폴더 조건이 어디까지 걸리는지 가늠하기 어려워서, v2.1.277을 설치한 맥에서 폴더 네 개를 만들어 직접 실행했습니다. 파일마다 다른 확인 코드를 적어 두고 클로드에게 그 코드를 물었습니다. 2026년 9월 19일의 결과입니다.

폴더 구성클로드가 답한 코드응답 코드가 있던 파일
AGENTS.md 하나만 둠AAA-111AGENTS.md
AGENTS.md와 CLAUDE.md를 같이 둠CCC-333CLAUDE.md
상위 폴더에 CLAUDE.md, 작업 폴더에 AGENTS.mdDDD-444상위 폴더의 CLAUDE.md
AGENTS.md와 CLAUDE.local.md를 같이 둠GGG-777CLAUDE.local.md

네 줄 모두 문서와 맞았습니다. 두 번째 폴더에서 claude-md-and-agents-md 설정으로 한 번 더 실행하자 클로드가 CLAUDE.md의 코드를 먼저 말하고 AGENTS.md의 코드를 이어서 말했습니다. 두 파일의 내용이 모두 세션에 들어온 것입니다. 파일이 올라오는 순서는 공식 문서대로 폴더마다 CLAUDE.md가 먼저입니다.

상위 폴더의 CLAUDE.md 하나 때문에 팀의 AGENTS.md가 올라오지 않는 구조

앞 실행 결과의 세 번째 줄을 폴더로 그리면 이렇습니다. 상위 폴더는 현재 폴더를 담고 있는 폴더입니다.

work/ ├── CLAUDE.md ← 예전에 만든 파일 └── blog/ └── AGENTS.md ← 팀이 새로 만든 규칙

blog에서 세션을 열어도 기본 설정은 위쪽 work/CLAUDE.md만 읽습니다. 어느 파일이 더 가까운지가 아니라, 위로 올라가는 경로 어딘가에 CLAUDE.md 계열 파일이 있는지로 정해지기 때문입니다.

기본 설정에서 클로드가 지시 파일을 고르는 순서

  1. 1. 위로 찾기작업 폴더부터 위쪽으로
    CLAUDE.md 계열 파일 찾기
  2. 2. 하나라도 있으면CLAUDE.md 계열만 읽고
    AGENTS.md는 건너뜀
  3. 3. 하나도 없으면AGENTS.md와
    .claude/AGENTS.md 읽기
  4. 4. 하위 폴더를 열 때그 폴더에 CLAUDE.md가 없으면
    그 폴더의 AGENTS.md 추가

모노레포에서 이 순서가 문제가 됩니다. 저장소 루트에 예전 CLAUDE.md가 남아 있고 패키지 폴더마다 AGENTS.md를 새로 만들었다면, 패키지 폴더에서 세션을 열어도 루트의 CLAUDE.md만 올라옵니다. 그래서 AGENTS.md로 옮기는 작업을 패키지 하나씩 나눠서 진행하기 어렵습니다.

알아채기 더 어려운 경우는 CLAUDE.local.md입니다. 공식 문서도 이 파일을 따로 경고합니다. 팀이 AGENTS.md를 쓰기로 한 저장소라도 한 사람이 개인 메모용으로 이 파일을 만들면, 그 사람의 세션에서는 팀 지시문이 통째로 빠집니다. 커밋되지 않는 파일이라 다른 사람 화면에서는 정상으로 동작하고, 그 사람 화면에서만 규칙이 빠진 채 작업이 진행됩니다. 개인 메모를 유지하면서 AGENTS.md도 읽게 하려면 다음 절의 claude-md-and-agents-md나 @AGENTS.md 가져오기를 씁니다.

Project instructions 설정값 네 가지

세션에서 /config를 열면 Project instructions 항목이 있고, 값은 위 문서 화면처럼 네 가지입니다.

Project instructions 값별로 읽는 파일

설정값CLAUDE.mdAGENTS.md
claude-md-or-agents-md (기본값)있으면 CLAUDE.md만CLAUDE.md가
없을 때만
claude-md-and-agents-md폴더마다 먼저CLAUDE.md 다음에
claude-md제공제공하지 않음
managed-only시작 때는 읽지 않음제공하지 않음
managed-only는 시작할 때 관리 정책 지침과 자동 메모리만 읽고, 이후 하위 폴더 파일을 열면 일부 CLAUDE.md와 경로별 규칙이 추가됩니다.

claude-md-and-agents-md를 골라도 같은 파일이 두 번 올라오지는 않습니다. CLAUDE.md가 @AGENTS.md로 불러오거나 심볼릭 링크(다른 파일을 가리키는 연결 파일)로 이어 둔 경우, 클로드 코드는 이미 읽은 AGENTS.md를 건너뜁니다.

/config에서 값을 바꾸기 전에 원래 값을 적어 둡니다. 사용자 범위로 저장한 변경은 다른 프로젝트에도 적용되기 때문입니다. 바꾼 값은 다음 메시지와 새 세션부터 반영됩니다.

설정 파일을 직접 편집할 수도 있습니다. AGENTS.md 지원은 내장 플러그인으로 들어가 있어서 pluginConfigs의 agents-md@builtin 아래에 적습니다. 기존 파일 전체를 아래 내용으로 덮어쓰지 말고 해당 항목만 합칩니다.

{ "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } }

여기서 놓치기 쉬운 것은 어느 설정 파일에 적느냐입니다. 프로젝트 폴더의 .claude/settings.json에 적은 값은 무시됩니다.

instructionFiles 값이 적용되는 설정 파일

설정 파일값이 적용됨
사용자 설정 ~/.claude/settings.json제공
--settings로 넘기는 파일제공
회사 관리 설정제공
프로젝트 .claude/settings.json제공하지 않음
저장소에 설정을 커밋해서 팀 전체에 같은 값을 적용할 수는 없습니다.

AGENTS.md로 읽을 때 CLAUDE.md와 달라지는 곳

설정을 켜도 직접 읽은 AGENTS.md는 CLAUDE.md와 똑같이 동작하지 않습니다. 차이는 다섯 군데입니다.

CLAUDE.md와 직접 읽은 AGENTS.md의 차이

항목CLAUDE.md직접 읽은 AGENTS.md
/memory 목록 표시제공v2.1.280부터
InstructionsLoaded 훅 실행제공제공하지 않음
--add-dir로 추가한 폴더환경 변수를
켜면 올라옴		제공하지 않음
작업 폴더 밖 @경로 불러오기불러오기 전
승인 질문		승인해 둔 경우만
묻지 않고 불러옴
하위 에이전트에 전달제공제공
CLAUDE.md가 @AGENTS.md로 불러온 AGENTS.md에서는 InstructionsLoaded 훅이 평소대로 실행됩니다.

v2.1.280 이전 버전에서는 직접 읽은 AGENTS.md가 /memory와 /context 어디에도 표시되지 않아서, 시작 안내와 규칙을 물었을 때의 응답으로 판단해야 했습니다.

훅은 정해진 이벤트에 맞춰 명령을 실행하는 기능입니다. 지시문이 올라올 때 InstructionsLoaded 훅으로 검증하거나 기록을 남기던 팀은, AGENTS.md를 직접 읽게 바꾸는 순간 그 훅이 아무 알림 없이 멈춥니다. --add-dir로 다른 폴더를 추가한 경우에는 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD를 켜 두면 그 폴더의 CLAUDE.md는 올라오지만 AGENTS.md는 올라오지 않습니다.

작업 폴더 밖 파일을 불러오는 규칙도 다릅니다. CLAUDE.md는 외부 파일을 불러오기 전에 승인을 묻고, AGENTS.md는 묻지 않습니다. AGENTS.md의 외부 가져오기는 그 프로젝트에서 이미 승인해 둔 경우에만 이뤄집니다. 훅과 외부 가져오기는 보안이나 운영 규칙을 강제하는 데 쓰이는 경우가 많아서, 그런 팀이라면 이 두 줄부터 봅니다.

하위 에이전트 쪽은 달라지지 않습니다. 프로젝트 지시문으로 올라온 AGENTS.md는 CLAUDE.md와 마찬가지로 하위 에이전트에게도 전달되고, Explore와 Plan 에이전트는 두 파일을 모두 건너뜁니다.

설정 항목이 없거나 파일이 읽히지 않을 때

원인은 대개 아래 다섯 가지 가운데 하나입니다. claude --version은 PowerShell이나 맥 터미널에서 입력하고, /config와 /plugin은 Claude Code 대화 안에서 입력합니다.

AGENTS.md가 읽히지 않는 원인별 확인 위치와 조치

원인확인할 곳조치
v2.1.277 미만claude --version업데이트
내장 agents-md 플러그인 꺼짐/plugin플러그인 켜기
일부 구버전에서 업그레이드한 직후 첫 세션–새 세션 다시 열기
베드록 같은 제3자 제공자에서 v2.1.281 미만claude --version업데이트, 안 되면
@AGENTS.md 가져오기
위쪽 폴더에 CLAUDE.md 계열 파일이 있음상위 폴더,
CLAUDE.local.md		설정값 변경이나
@AGENTS.md 가져오기

업데이트가 막힌 회사 환경이라면 같은 폴더의 CLAUDE.md에 @AGENTS.md 한 줄을 넣는 방법을 씁니다. 자세한 방법은 아래 우회법 정리 절에 있습니다.

1년 넘게 쌓인 요청과 공개 직후 반응

이 기능은 깃허브 이슈 하나에 1년 넘게 요청이 쌓인 끝에 나왔습니다. 2025년 8월 21일에 올라온 6235번 이슈는 "코덱스와 앰프, 커서가 AGENTS.md로 표준을 잡아 가는데 CLAUDE.md는 클로드 코드에만 너무 맞춰져 있어서, 클로드 코드를 쓰지 않는 개발자와 협업할 때 잘 맞지 않는다"는 짧은 글로 시작했습니다.

2026년 9월 19일 기준 이 이슈에는 엄지 반응 5,168개와 댓글 399개가 있었습니다. 지원을 미루는 이유가 기술이 아니라 브랜드 노출이라고 보는 댓글이 여러 개 달렸고, CLAUDE.md에 AGENTS.md를 읽으라는 문장을 넣고 Git 기록에서 제외하는 우회법도 공유됐습니다. 공개 당일에는 앤트로픽 쪽 공지 게시글을 그대로 옮겨 붙이고 "Finally!!"를 덧붙인 댓글이 올라왔습니다.

그사이 AGENTS.md를 쓰는 곳도 크게 늘었습니다. 공식 사이트는 6만 개가 넘는 오픈소스 프로젝트가 이 형식을 쓰고 있다고 적고 있고, 지금은 리눅스 재단 산하 Agentic AI Foundation이 관리합니다.

쓰던 우회법을 정리하는 방법

공식 지원 전에 직접 만들어 둔 설정이 있다면, 그대로 둬도 되는 것과 지금 바꿀 것을 먼저 나눕니다.

공식 지원 전 우회법별로 지금 할 일

쓰던 방법그대로 둬도 됨지금 할 일
CLAUDE.md에 @AGENTS.md를 적어 둠제공없음
어느 설정값에서도 두 번 읽지 않음
CLAUDE.md에 "AGENTS.md를 읽어라"라는 문장을 적어 둠제공하지 않음기존 규칙은 두고
@AGENTS.md 가져오기로 교체
CLAUDE.md를 AGENTS.md 심볼릭 링크로 만듦–팀원의 운영체제를 보고
유지 여부 결정
SessionStart 훅으로 AGENTS.md를 출력제공하지 않음직접 로딩을 본 뒤
출력 부분만 삭제

SessionStart 훅을 그대로 두면 클로드가 직접 읽은 AGENTS.md 위에 훅이 출력한 사본이 한 벌 더 올라와, 클로드가 같은 규칙을 두 번 읽습니다. 그래서 /memory에서 AGENTS.md가 직접 올라온 것을 본 뒤에 훅의 출력 부분만 지우고, 훅이 하던 다른 동작은 남깁니다.

심볼릭 링크를 쓰던 팀은 두 가지를 같이 봅니다. 클로드는 링크를 따라 읽지만 Edit와 Write 도구는 링크로 연결된 파일에 쓰지 못합니다. 또 윈도우에서는 관리자 권한이나 개발자 모드 없이 링크를 만들지 못해서, 링크가 평범한 텍스트 파일로 체크아웃되면 그 컴퓨터에서는 경로 한 줄만 적힌 CLAUDE.md가 지시문을 대신하게 됩니다.

가져오기 방식은 AGENTS.md와 같은 폴더의 CLAUDE.md에 아래 한 줄을 넣는 방법입니다. 기존 CLAUDE.md가 있다면 원래 내용 아래에 덧붙이고, 같은 줄이 이미 있는지 먼저 봅니다.

@AGENTS.md

이 방법은 AGENTS.md를 직접 읽는 기능이 아니라 CLAUDE.md의 가져오기 문법입니다. 그래서 앞에서 본 InstructionsLoaded 훅도 평소대로 실행됩니다.

클로드가 AGENTS.md를 읽었는지 확인하는 순서

설정을 바꾸거나 우회법을 정리한 뒤에는 기존 규칙 파일을 지우기 전에 실제 프로젝트에서 아래 순서로 봅니다.

기존 파일을 지우지 않고 로딩을 확인하는 순서

  1. 1. 버전터미널에서 claude --version,
    v2.1.277 이상인지 보기
  2. 2. 설정값/config의 Project
    instructions 값 보기
  3. 3. 새 세션/exit로 나온 뒤
    같은 폴더에서 claude
  4. 4. 목록/memory에 AGENTS.md
    경로가 있는지 보기
  5. 5. 규칙 질문AGENTS.md에만 적힌 규칙을
    파일을 열지 말고 답하게

4번의 목록 표시는 v2.1.280부터 있습니다. 5번에서는 “추가 파일 검색 없이, 지금 전달받은 프로젝트 규칙 가운데 작업 결과를 어떤 언어로 설명하라고 되어 있는지 말해 줘”처럼 AGENTS.md에만 적힌 규칙을 묻습니다. 이때 클로드가 파일 읽기 도구로 AGENTS.md를 새로 열었다면, 시작할 때 자동으로 읽은 것이 아니라 질문을 받고 연 것입니다.

AGENTS.md가 목록에 없거나 규칙을 답하지 못하면 앞 절의 다섯 가지 원인을 위에서부터 차례로 봅니다. 여러 규칙 파일을 한꺼번에 지우면 어느 파일 때문이었는지 알 수 없게 되므로, 하나를 바꿀 때마다 새 세션을 열어 다시 묻습니다. 확인을 위해 사용자 설정을 바꿨다면 마지막에 원래 값으로 되돌립니다.

자주 묻는 질문

CLAUDE.md를 지우면 AGENTS.md를 바로 읽나요?

기본 설정이고 v2.1.277 이상이라면, 작업 폴더와 상위 경로에 CLAUDE.md 계열 파일이 하나도 없을 때 AGENTS.md를 읽습니다. .claude/CLAUDE.md와 CLAUDE.local.md도 CLAUDE.md 계열에 들어가고, 일부 구버전에서 업그레이드한 직후 첫 세션은 예외입니다. 지우기보다 @AGENTS.md 가져오기로 두 파일을 함께 쓰는 방법을 먼저 검토합니다.

두 파일을 함께 쓰면 규칙이 충돌하지 않나요?

올라오는 순서는 정해져 있습니다. 폴더마다 CLAUDE.md가 먼저 올라오고 그 뒤에 AGENTS.md가 올라옵니다. 충돌 자체를 막아 주는 장치는 없으므로, 공통 규칙은 AGENTS.md에 두고 클로드에만 해당하는 내용만 CLAUDE.md에 남기는 방법이 무난하다고 봅니다.

아마존 베드록에서도 쓸 수 있나요?

v2.1.281 이상이면 직접 로딩을 쓸 수 있습니다. 그보다 이전 버전은 베드록 같은 제3자 제공자 환경에서 직접 로딩이 제한되므로 업데이트하고, 업데이트할 수 없으면 CLAUDE.md의 @AGENTS.md 가져오기를 씁니다.

Sources

3줄 요약

  1. Claude Code는 2026년 9월 18일 배포된 v2.1.277부터 AGENTS.md를 직접 읽지만, 기본 설정에서는 작업 폴더와 상위 폴더에 CLAUDE.md 계열 파일이 있으면 AGENTS.md를 읽지 않습니다.

  2. 두 파일을 함께 읽게 하려면 CLAUDE.md에 @AGENTS.md를 넣거나 사용자 설정에서 Project instructions를 claude-md-and-agents-md로 바꾸고, 이 값을 프로젝트 폴더의 설정 파일에 적으면 무시됩니다.

  3. 직접 읽은 AGENTS.md는 v2.1.280부터 /memory 목록에 표시되지만 InstructionsLoaded 훅은 실행되지 않으며, v2.1.281 이전 버전은 베드록 같은 제3자 제공자 환경에서 직접 로딩이 제한됩니다.

Share

제대로 이해했는지 한 문제로 확인해 볼까요?

답을 고르면 바로 풀이가 나와요.

기본 claude-md-or-agents-md 설정이며 별도 가져오기가 없을 때, 상위 폴더에 CLAUDE.md가 있고 작업 폴더에 AGENTS.md가 있으면 무엇을 읽을까요?

이 글이 도움이 되었나요?

이 글 다음 배우기AI 에이전트 중급: 원리와 설계중급 코스 · 5편

도구에 상관없이 통하는 에이전트 원리와 설계 규칙을 정리했습니다

  1. 1AI 에이전트(AI Agent) 뜻: 챗봇, 워크플로와의 차이, 에이전트 루프와 도구 호출, MCP와 스킬
  2. 2AGENTS.md와 CLAUDE.md 뜻과 작성법: intent.md와 하네스까지
  3. 3멀티 에이전트 오케스트레이션(Multi-Agent Orchestration) 뜻과 설계
코스 전체 보기 →
이어서 읽기 좋은 글클로드 코드(Claude Code) CLAUDE.md 세팅, 알려진 노하우들과 공식 문서 업데이트 정리 →

CLAUDE.md를 만들고 클로드 코드가 불러왔는지 /context로 확인하는 순서, 200줄 권장의 실제 의미, 훅과 권한 설정으로 막아야 할 동작, 스킬과 경로 규칙으로 옮길 내용을 공식 문서 기준으로 정리했습니다.

함께 읽으면 좋은 글

관련 개념