Claude Code ELI5 설치 및 사용법: 실무 프롬프트와 커스텀 eli 스킬
Claude Code ELI5 플러그인의 설치·사용법, 오류 해결, 실무 프롬프트 5개와 5살·입문·실무 단계로 확장한 커스텀 eli 스킬 코드를 소개합니다.
업데이트 기준: 2026년 8월 27일
이런 분을 위한 글입니다
- Claude Code로 낯선 프로젝트를 빠르게 이해하고 싶은 분
- 복잡한 기술을 그림 중심으로 설명하고 싶은 분
- ELI5를 실무 수준으로 확장한 커스텀 스킬이 필요한 분
읽고 나면 이렇게 달라집니다
- ELI5 플러그인을 설치하고 정상 동작을 확인할 수 있다
- 온보딩·기술 결정·장애 분석 프롬프트를 바로 활용할 수 있다
- 5살·입문·실무 수준을 지원하는 eli 스킬을 직접 설치할 수 있다
새 프로젝트에 합류하면 README부터 읽습니다. 그런데 끝까지 읽어도 전체 구조가 선명하게 그려지지 않을 때가 많습니다. AI에게 물어보면 이번에는 긴 글과 낯선 용어가 돌아옵니다.
이럴 때 유용한 Claude Code 스킬이 ELI5입니다. ELI5는 ‘Explain Like I'm 5’의 줄임말입니다. 복잡한 주제를 아무것도 모르는 사람도 이해할 수 있도록 큰 그림과 짧은 문장으로 풀어줍니다. 공식 소스에서 설명하는 결과물은 큰 이미지와 적은 글로 구성된 HTML 아티팩트입니다.
이 글에서는 ELI5 설치부터 실제 업무용 프롬프트까지 따라 해봅니다. 마지막에는 설명 깊이를 5살·입문·실무 세 단계로 확장한 커스텀 eli 스킬도 그대로 제공합니다.
ELI5는 Claude Code의 기본 내장 기능이 아닙니다. Anthropic 커뮤니티 마켓플레이스에 공개된 플러그인입니다. 설치 전에 소스와 추가되는 구성요소를 확인하세요.
30초 요약
Claude Code ELI5는 복잡한 기술이나 프로젝트 구조를 초보자도 이해하기 쉬운 HTML 설명 화면으로 만드는 커뮤니티 플러그인입니다. 커뮤니티 마켓플레이스를 추가한 뒤 ELI5를 설치하고, Claude Code에서 /eli5 <주제> 형식으로 사용합니다.
| 궁금한 점 | 답 |
|---|---|
| ELI5는 무엇인가요? | 큰 이미지와 적은 글로 주제를 쉽게 설명하는 Claude Code 스킬입니다. |
| 설치에 필요한 것은 무엇인가요? | Claude Code가 먼저 설치되어 있어야 합니다. |
| 첫 명령어는 무엇인가요? | /eli5 설명할 주제입니다. |
| 프로젝트도 설명할 수 있나요? | 프로젝트 폴더에서 파일 읽기를 허용하고 근거 파일을 지정하면 코드 구조를 바탕으로 설명할 수 있습니다. |
| 공식 내장 기능인가요? | 아닙니다. Anthropic 커뮤니티 마켓플레이스의 플러그인입니다. |
ELI5는 무엇을 해주나요?
공식 ELI5 플러그인 소스는 주제를 5살에게 설명하듯 풀고, 큰 그림과 적은 글로 구성된 HTML 아티팩트를 만든다고 설명합니다. 플러그인 메타데이터에 표시된 작성자는 Thariq Shihipar입니다.
예를 들어 DNS를 설명해줘라고 요청하면 사전식 정의보다 비유와 시각 자료를 중심으로 전체 그림을 보여주도록 요청할 수 있습니다. 프로젝트 폴더에서 실행하고 파일 읽기를 허용하면 README와 코드 구조를 근거로 프로젝트의 동작 흐름도 설명할 수 있습니다. 실제 결과는 사용 중인 Claude Code 환경과 아티팩트 지원 여부에 따라 달라질 수 있습니다.
ELI5가 특히 유용한 순간은 다음과 같습니다.
- 처음 보는 프로젝트의 전체 구조를 파악할 때
- 낯선 기술 개념을 큰 그림부터 이해할 때
- 새 동료를 위한 온보딩 자료를 만들 때
- 기술 의사결정의 배경을 팀에 설명할 때
- 장애의 정상 흐름과 실패 흐름을 비교할 때
30초 만에 설치하기
전제 조건은 Claude Code가 설치되어 있는 것입니다. 일반 터미널에서 다음 두 줄을 순서대로 실행합니다.
claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install eli5@claude-community첫 번째 명령어는 Anthropic 커뮤니티 마켓플레이스를 추가합니다. 두 번째 명령어는 그 마켓플레이스에서 ELI5 플러그인을 설치합니다.
이미 Claude Code 세션 안에 있다면 슬래시 명령어를 사용해도 됩니다.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install eli5@claude-community커뮤니티 마켓플레이스는 Anthropic이 유지하는 공식 플러그인 마켓플레이스와 구분됩니다. Claude Code 공식 문서에 따르면 커뮤니티 등록 항목은 자동 검증과 안전성 심사를 거치지만, 설치 전 세부 화면에서 추가되는 스킬·에이전트·훅·MCP 서버 등을 직접 확인해야 합니다.
설치 확인하기
터미널에서 설치 목록을 확인합니다.
claude plugin list목록에서 eli5@claude-community를 찾습니다. 상태가 enabled라면 설치가 끝난 것입니다.
Claude Code 세션 안에서는 다음 명령어도 사용할 수 있습니다.
/plugin list설치 직후 ELI5가 보이지 않는다면 새 Claude Code 세션을 열어보세요. 현재 세션에서 바로 다시 불러오려면 다음 명령어를 실행합니다.
/reload-plugins다시 불러오는 과정에서 강제 실행 안내가 나오면 다음처럼 실행합니다.
/reload-plugins --force첫 번째 ELI5 실행하기
프로젝트 폴더에서 Claude Code를 실행한 뒤 다음 프롬프트를 붙여넣습니다.
/eli5 이 프로젝트가 어떻게 동작하는지,
오늘 처음 합류한 동료도 이해할 수 있게 설명해줘큰 그림과 적은 글로 구성된 HTML 아티팩트가 생성되면 정상입니다. 표시 방식은 사용 중인 Claude Code 환경에 따라 달라질 수 있습니다.
단순히 “이 프로젝트 설명해줘”라고 요청하는 것보다 보고 싶은 항목을 구체적으로 적으면 결과가 좋아집니다.
/eli5 이 프로젝트를 오늘 처음 본 동료에게 설명해줘.
- 핵심 구성요소와 각 역할
- 요청이 들어와 결과가 나가기까지의 흐름
- 가장 먼저 읽어야 할 파일 3개
README와 실제 코드 구조를 근거로 큰 그림부터 보여줘.업무에서 바로 쓰는 프롬프트 5개
아래 프롬프트는 대괄호 안의 내용만 바꿔서 사용할 수 있습니다.
1. 새 동료 온보딩
/eli5 이 프로젝트를 오늘 처음 본 동료에게 설명해줘.
- 이 프로젝트가 해결하는 문제
- 핵심 구성요소와 각 역할
- 요청이 들어와 결과가 나가기까지의 흐름
- 가장 먼저 읽어야 할 파일 3개
- 처음 수정하기 좋은 작은 기능 1개
README와 실제 코드 구조를 근거로 큰 그림부터 보여줘.2. 특정 기능의 코드 흐름 이해
/eli5 [기능명]이 어떻게 동작하는지 설명해줘.
사용자의 행동부터 최종 결과가 화면에 나타날 때까지
관련 파일과 함수가 어떤 순서로 호출되는지 보여줘.
각 단계에서 입력과 출력이 무엇인지 함께 적어줘.
추측하지 말고 실제 코드에 근거해줘.3. 기술 의사결정 이해
/eli5 왜 [기술 A] 대신 [기술 B]를 선택했는지 설명해줘.
당시 제약 조건, 얻은 이점, 감수한 트레이드오프,
그리고 이 결정을 다시 검토해야 할 신호를 보여줘.
관련 ADR, PR, 설정 파일을 근거로 사용해줘.
근거를 찾지 못한 내용은 추측이라고 표시해줘.4. 장애 원인 분석
/eli5 [장애명 또는 발생 시각] 장애가 어떻게 발생했는지 설명해줘.
정상 흐름과 실패 흐름을 나란히 비교하고,
최초 원인, 증폭 요인, 탐지 지연, 재발 방지 조치를 보여줘.
로그, 변경 내역, 인시던트 문서를 근거로 사용해줘.
확인된 사실과 추정한 내용을 구분해줘.5. 어려운 기술 개념 학습
/eli5 [기술 개념]을 처음 듣는 사람에게 설명해줘.
먼저 일상적인 비유로 큰 그림을 보여주고,
그다음 실제 개발에서 어떤 문제를 해결하는지 설명해줘.
마지막에는 최소한의 코드 예시와 흔한 실수 3개를 보여줘.대상 파일, 로그, PR, ADR을 함께 지정할수록 결과가 구체적입니다. 큰 주제 하나보다 지금 이해하려는 흐름 하나를 좁혀 질문하세요.
결과가 아쉬울 때 프롬프트를 고치는 법
ELI5는 그림을 쉽게 만들어주지만, 그림이 쉽다고 내용까지 항상 정확한 것은 아닙니다. 특히 숫자, 성능 수치, 장애 원인은 원본 자료와 다시 대조해야 합니다.
다음 네 가지를 프롬프트에 추가하면 품질이 좋아집니다.
- 독자를 지정합니다. “백엔드 신입 개발자에게 설명해줘”처럼 적습니다.
- 근거를 지정합니다. README, 특정 파일, 로그, PR, ADR을 함께 적습니다.
- 범위를 좁힙니다. “쿠버네티스”보다 “Kubernetes HPA가 Pod 수를 조절하는 흐름”이 좋습니다.
- 사실과 추정을 구분하게 합니다. “근거를 찾지 못한 내용은 추측이라고 표시해줘”를 덧붙입니다.
바로 복사할 수 있는 보정 프롬프트입니다.
방금 만든 설명을 다시 검토해줘.
- 실제 파일에서 확인한 사실과 추측을 구분해줘.
- 숫자와 명령어는 출처 또는 근거 파일을 표시해줘.
- 설명 범위를 [알고 싶은 구체적인 흐름]으로 좁혀줘.
- [대상 독자]가 모를 용어는 처음 나올 때 한 줄로 정의해줘.
- 잘못 이해하기 쉬운 부분을 마지막에 따로 정리해줘.ELI5를 실무 수준으로 확장한 eli
ELI5를 사용해보면 큰 그림을 이해하기에는 좋지만, 그다음 단계가 아쉬울 수 있습니다. 쉬운 설명 뒤에 실제 동작, 트레이드오프, 실패 지점까지 이어서 보고 싶기 때문입니다.
그래서 독자 수준을 세 단계로 나눈 커스텀 스킬 eli를 만들었습니다.
ELI5와 커스텀 eli의 차이
| 구분 | ELI5 플러그인 | 커스텀 eli 스킬 |
|---|---|---|
| 목적 | 처음 듣는 사람에게 쉽게 설명 | 쉬운 이해에서 실무 적용까지 단계별 설명 |
| 설명 수준 | 한 가지 | 5살·입문·실무 세 가지 |
| 결과 형식 | 큰 이미지와 적은 글의 HTML 아티팩트 | 수준별 단일 화면 또는 탭형 HTML 아티팩트 |
| 실무 내용 | 질문에 따라 달라짐 | 트레이드오프·실패 지점·코드 예시를 명시적으로 요구 |
| 설치 방식 | 커뮤니티 마켓플레이스에서 설치 | 개인 스킬 폴더에 SKILL.md 생성 |
설명 수준 비교
| 등급 | 독자 | 설명 범위 |
|---|---|---|
| 5살 | 처음 듣는 사람 | 일상적인 비유와 역할 중심 |
| 입문 | 배우기 시작한 사람 | 비유, 핵심 용어, 실제 동작 한 단계 |
| 실무 | 업무에서 사용하는 사람 | 실제 흐름, 트레이드오프, 실패 지점, 코드 |
수준을 적지 않으면 한 화면에 세 개의 탭을 만듭니다.
/eli DNS
/eli 5 DNS
/eli 입문 DNS
/eli 실무 DNS주제와 독자를 더 구체적으로 지정할 수도 있습니다.
/eli 실무 MCP를 처음 도입하는 백엔드 신입에게 설명해줘
/eli 실무 이 저장소의 인증 요청 흐름을 설명해줘
/eli 입문 git rebase -i에서 squash가 동작하는 과정을 설명해줘커스텀 eli 스킬 설치하기
Claude Code 세션에서 아래 프롬프트를 그대로 붙여넣으세요. Claude Code가 ~/.claude/skills/eli/SKILL.md 파일을 만들고 설치 결과를 확인합니다.
Claude Code 스킬 `eli`를 설치해줘.
아래 파일을 정확히 이 내용으로 만들어.
내용은 한 글자도 바꾸지 마.
다 만들면 `cat ~/.claude/skills/eli/SKILL.md | head -5`로 확인하고,
새 세션에서 /eli DNS처럼 쓸 수 있다고 알려줘.
===== 파일: ~/.claude/skills/eli/SKILL.md =====아래 내용을 위 프롬프트 바로 다음에 이어서 붙여넣습니다.
위 스킬은 artifact-design 스킬을 먼저 불러오도록 설계되어 있습니다. 해당 스킬이 설치되어 있지 않거나 환경에서 제공되지 않으면 그 부분을 제거하거나, 사용할 수 있는 디자인 스킬 이름으로 바꿔야 합니다.
잘 안 될 때 확인할 것
자주 묻는 질문
Claude Code ELI5는 무료인가요?
ELI5 플러그인 소스의 라이선스는 MIT로 표시되어 있습니다. 다만 Claude Code 사용에 필요한 요금이나 이용 조건은 사용자의 Claude 플랜과 실행 환경에 따라 별도로 적용됩니다.
ELI5는 Anthropic 공식 내장 스킬인가요?
아닙니다. ELI5는 anthropics/claude-plugins-community에 등록된 커뮤니티 플러그인입니다. Anthropic이 유지하는 공식 플러그인 마켓플레이스와는 구분됩니다.
ELI5는 내 프로젝트 코드를 자동으로 읽나요?
프로젝트 폴더에서 실행하더라도 파일 접근은 Claude Code의 권한과 사용자의 승인 범위에 따릅니다. README나 특정 코드 파일을 근거로 삼고 싶다면 프롬프트에 대상 파일을 명시하는 것이 안전합니다.
/eli5가 보이지 않을 때는 어떻게 하나요?
먼저 claude plugin list에서 설치 여부와 활성화 상태를 확인합니다. 새 세션을 열거나 /reload-plugins를 실행하고, 필요한 경우 /reload-plugins --force로 다시 불러옵니다.
ELI5가 만든 설명을 그대로 믿어도 되나요?
아닙니다. 이해를 돕는 첫 자료로 사용하되, 명령어·숫자·성능 수치·장애 원인은 실제 코드와 로그, 공식 문서에서 다시 확인해야 합니다.
마무리
ELI5의 장점은 어려운 내용을 무조건 짧게 만드는 것이 아닙니다. 전체 그림을 먼저 보여줘서 다음에 무엇을 읽어야 할지 알게 만드는 것입니다.
처음에는 다음 한 줄로 시작해보세요.
/eli5 이 프로젝트가 어떻게 동작하는지,
오늘 처음 합류한 동료도 이해할 수 있게 설명해줘설명이 너무 얕다면 독자 수준, 대상 파일, 보고 싶은 흐름을 추가합니다. 이해한 뒤 실제 동작과 실패 지점까지 보고 싶다면 커스텀 eli의 입문·실무 단계를 사용해보세요.
가장 중요한 마지막 단계는 검증입니다. ELI5가 만든 그림은 이해의 출발점으로 사용하고, 숫자와 사실은 반드시 실제 코드와 공식 문서에서 다시 확인하세요.