Attention Span은 Claude Code 답변의 전달 방식을 바꾸는 세 가지 출력 스타일 모음이다. 편안하게 요점을 읽는 Attention-kind, 직설적으로 판단을 받는 Spartan, 진행 상태를 훑는 Rundown을 설치하고 상황에 맞게 고르는 방법을 소개한다.
Attention Span 설치 방법: Claude Code에서 플러그인 추가
Claude Code가 설치되어 있다면 세션 안에서 바로 추가할 수 있다. 파일 다운로드나 JSON 편집은 필요 없다.
1. 플러그인 설치
Claude Code 입력창에서 아래 명령을 차례로 실행하고 설치 패널에서 범위를 선택한다. 출력 스타일 세 개와 스킬이 함께 설치된다.
/plugin marketplace add alexgreensh/attention-span
/plugin install attention-span@attention-span2. 원하는 방식으로 켜기
- 출력 스타일로 사용:
/config에서 Output style에서 Attention-kind·Spartan·Rundown 중 하나를 선택한다. - 이번 대화에서 스킬로 사용:
/attention-span:attention-kind,/attention-span:spartan,/attention-span:rundown중 하나를 입력한다.
3. 적용 확인
출력 스타일을 골랐다면 선택 목록에서 고른 스타일 옆의 ✔를 확인한다. 스킬을 불렀다면 새 질문을 보내 결론부터 답하는지 확인한다.
플러그인 없이 스킬만 설치하려면
스킬 파일만 프로젝트에 추가해도 된다. 파일을 직접 다루기보다 Claude Code에 다음처럼 설치를 요청할 수 있다.
https://github.com/alexgreensh/attention-span 의
skills/attention-kind/SKILL.md를 이 프로젝트의
.claude/skills/attention-kind/SKILL.md에 설치해줘.추가한 뒤 /attention-kind로 호출한다. 플러그인 설치와 스킬 단독 설치는 둘 중 하나를 고르면 된다.
Attention-kind·Spartan·Rundown, 어떤 스타일을 고를까
셋은 답변을 전달하는 방식이 다르다. 하나를 가장 좋은 스타일로 정하기보다, 설명을 읽을지·빠르게 판단할지·진행 상황을 확인할지에 맞춰 고르면 된다.
Attention-kind: 편안하게 핵심을 따라가고 싶을 때
차분하고 친근한 말투로 결론부터 답한다. 화살표 단락과 굵은 글씨로 요점을 나누고, 중요한 부분에는 짧은 설명을 붙인다. 다룰 주제가 너무 넓으면 핵심부터 말하고 나머지 주제를 이어 읽을 수 있게 안내한다. 기술 설명이나 선택지의 이유를 부담 없이 읽는 대화에 맞는다.
플러그인 스킬: /attention-span:attention-kind
Spartan: 완곡한 말 없이 판단과 행동만 받고 싶을 때
친근한 표현과 완충 문장을 빼고 직설적으로 답한다. Attention-kind처럼 화살표와 강조를 쓰지만 말투는 더 단호하고 명령형에 가깝다. 배경·예시·부연은 덜어도 필요한 조건과 경고는 남긴다. 집중 작업 중 수정 방향이나 다음 행동을 빠르게 확인할 때 고를 수 있다.
플러그인 스킬: /attention-span:spartan
Rundown: 무엇이 끝났고 무엇이 막혔는지 보고 싶을 때
첫 줄의 TL;DR 뒤에 상태판을 보여준다. ✅ 완료, 🟡 진행 중, ⬜ 시작 전, ❔ 알 수 없음으로 구분하고, 막힌 일은 🔴로 따로 드러낸다. 다음 선택지는 Your move: 아래 번호 목록으로 제시한다. 작업 보고·스탠드업·인수인계에 맞는 형식이다.
Rundown은 가장 짧은 답을 만드는 용도가 아니다. 길이를 줄이기보다 상태와 선택지를 빠르게 훑는 데 초점을 둔다. 주어지지 않은 상태를 만들어 쓰지 않고 모르면 모른다고 표시하라는 규칙도 포함한다.
플러그인 스킬: /attention-span:rundown
셋 모두 중요한 수치·조건·위험은 남기고, 사용자가 자세한 설명을 요청하면 간결함보다 설명의 충실함을 우선한다. 세 파일 모두 keep-coding-instructions: true를 사용해 Claude Code의 기본 코딩 지시문을 유지한다. 이것만으로 모든 작업의 성능이 같다고 보장되는 것은 아니다.
같은 현황을 세 스타일로 보고한 실제 답변
차이를 보기 위해 동일한 가상 상황을 각 스타일에 한 번씩 전달했다. Claude Code 2.1.291·Claude Opus 5.5에서 별도 프로젝트에 공식 스타일 파일을 넣어 실행했고, 로그의 output_style 값을 확인했다. 실제 주문 운영 보고나 성능 순위가 아니라 전달 형식을 보는 예다.
공통 입력: 주문 수집 완료, 중복 검증 진행 중, 출고 시작 전, 배송비 확정 여부는 알 수 없음. 담당자에게 배송비를 확인해야 하고 검증이 끝나야 출고할 수 있다.
Attention-kind 실제 출력
지금은 중복 주문 검증을 끝내는 게 우선이고, 출고는 검증이 끝나야 시작할 수 있어요.
1 → 주문 수집: 완료.
2 → 중복 주문 검증: 진행 중. 이게 끝나야 출고가 가능해요.
3 → 출고: 아직 시작 전. 검증 완료 전에는 시작하면 안 돼요.
4 → 배송비: 확정 여부 모름. 담당자에게 확인이 필요해요.
다음 행동: 중복 주문 검증을 마무리하고, 동시에 담당자에게 배송비 확정 여부를 확인하세요. 검증이 끝나면 출고를 시작할 수 있어요.
Spartan 실제 출력
검증 진행 중이라 출고 대기 상태이고, 다음 행동은 검증 완료와 담당자에게 배송비 확인입니다.
→ 주문 수집: 완료.
→ 중복 주문 검증: 진행 중. 검증이 끝나야 출고 가능.
→ 출고: 미시작.
→ 배송비: 확정 여부 모름. 담당자에게 확인 필요.
→ 다음 행동: 중복 주문 검증 완료, 담당자에게 배송비 확정 여부 확인, 검증 완료 후 출고 시작.
Rundown 실제 출력
TL;DR: 주문 수집은 끝났고 중복 주문 검증이 진행 중이라 출고는 검증 완료 전까지 막혀 있습니다. 배송비 확정 여부도 아직 모릅니다.
✅ 주문 수집: 완료
🟡 중복 주문 검증: 진행 중
⬜ 출고: 아직 시작 안 함
❔ 배송비 확정: 확정 여부 모름. 담당자 확인 필요
🔴 출고 대기: 중복 주문 검증이 끝나야 출고할 수 있음
Your move:
1. 📞 배송비 확정 여부를 담당자에게 확인
2. 🔍 중복 주문 검증 마무리
3. 📦 검증이 끝나면 출고 시작
세 조건은 각각 1회 실행했다. 매번 같은 모양으로 답하거나 어느 스타일이 항상 더 짧다고 보장하는 비교는 아니다. 아래의 토큰·시간·코드 검증은 별도의 기본 스타일 대 Attention-kind 실험이며 Spartan·Rundown의 성능 수치가 아니다.
같은 질문을 두 번 물었다: 기본 스타일과 Attention-kind 실측
설치가 끝났으니 실제로 무엇이 달라지는지 같은 조건에서 한 번 비교했다. 임시 프로젝트 폴더 두 개를 만들고 한쪽은 outputStyle을 default, 다른 쪽은 Attention-kind로 둔 뒤, 사용자 설정과 플러그인이 끼어들지 않도록 --setting-sources project,local로 프로젝트 설정만 읽게 했다. 도구는 모두 끄고 모델은 양쪽 모두 claude-opus-5-5, Claude Code 2.1.291이다. 질문은 하나다. 주문 CSV에서 같은 order_id가 두 번 나오면 첫 행만 남기는 표준 라이브러리 함수를 쓰고, 예시 입력의 결과와 중복 제거 기준을 제시하라.
두 답변의 함수는 기본 스타일 쪽에 docstring 한 줄이 더 있을 뿐 본문이 같았다. 집합으로 본 적 있는 order_id를 기억하고 처음 행만 결과 리스트에 쌓는 dedupe_first다. 두 답변에서 그 코드를 꺼내 예시 입력에 그대로 실행해 보니 둘 다 A(100), B(300) 두 행이 남아 기대값과 일치했다. 달라진 것은 포장이다. 기본 스타일은 코드 블록으로 시작해 결과, 기준 네 항목, 그리고 csv.DictReader로 읽는 보충 코드까지 이어졌다. Attention-kind는 "결과는 A(100), B(300) 두 행이며…"라는 굵은 결론 한 문장으로 시작하고, 기준을 1 →부터 4 →까지 네 단락으로 나눴다. 공백을 뺀 글자 수는 860자에서 644자로 약 25% 줄었고 출력 토큰은 703개에서 584개로 줄었다.
CLI가 보고한 정가 환산액과 API 시간은 이 한 번의 실행에서 오히려 늘었다. 기본 스타일이 API 시간 6.8초에 0.033달러, Attention-kind가 10.8초에 0.051달러였다. 달러 값은 CLI의 total_cost_usd이며, 이 실행 메타데이터의 costBasis는 list다. Claude Max 구독 계정에서 이 금액을 건별로 결제했다는 뜻이 아니다. 시간과 환산액은 출력 길이 외에 입력·캐시 상태 등에도 영향을 받으므로 이 표본만으로 증가 원인을 분리할 수 없다. README도 토큰 절감은 부수 효과이고 목적은 읽기 쉬운 답이라고 선을 긋는다. 표본이 하나인 실측이므로 "항상 빠르다" 또는 "항상 싸다"로 읽을 수 없다. 확실히 말할 수 있는 것은 docstring을 제외한 함수 로직과 실행 결과가 같았고, 결론이 첫 줄로 올라왔고, 경고(값을 정규화하지 않으며 열이 없으면 KeyError가 난다)는 사라지지 않고 남았다는 점이다.
어디에 쓰고, 어디서는 끄는가
짧은 답만 원한다면 추가 설치 없이 내장 Concise 스타일도 선택지다. 공식 문서상 Claude Code 2.1.237 이상에서 제공한다. Attention-kind는 화살표 단락, 훑어읽기용 강조, 조건과 경고를 유지하라는 구체적인 지시를 함께 쓰고 싶을 때 비교해 볼 만하다.
설명은 Attention-kind, 직설적인 판단은 Spartan, 상태 보고는 Rundown에서 시작해 볼 수 있다. 모두 같은 플러그인에 들어 있으므로 다시 설치하지 않고 /config에서 선택을 바꾸면 된다. 스킬은 사용자가 호출해야 적용된다.
Claude Code 밖에서도 쓸 수 있다. 파일 본문은 Claude 전용 문법이 없는 마크다운이고, 맨 위 frontmatter만 Claude Code가 읽는 부분이다. README는 sed '1,/<!-- body-start -->/d'로 frontmatter를 떼어 Codex의 AGENTS.md나 Devin의 규칙 폴더에 붙이는 명령을 제공한다.
끄거나 기대하지 말아야 할 지점도 분명하다. 출력 스타일은 메인 대화에만 적용되고 서브에이전트는 자기 시스템 프롬프트로 돈다. 공식 문서가 강조하듯 스타일은 Claude가 따르는 지시일 뿐 보장이 아니어서, 매번 반드시 일어나야 하는 일은 훅(hook)으로 걸어야 한다. 짧은 답이 불편한 순간, 예를 들어 처음 보는 코드베이스의 설명을 길게 듣고 싶을 때는 "자세히 설명해 달라"고 쓰면 스타일 자체가 간결 규칙을 풀어 주지만, 그래도 답답하면 /output-style default로 돌아가면 된다. 라이선스는 AGPL-3.0이고, 현재 버전은 2026년 9월 6일에 나온 0.8이다.
직접 파일을 관리하려는 경우: 수동 설치
아래는 플러그인·스킬 설치 대신 파일과 설정을 직접 관리할 때만 필요한 방법이다. 이 글의 답변 비교는 이 방식으로 진행했다.
mkdir -p .claude/output-styles
curl -o .claude/output-styles/attention-kind.md \
https://raw.githubusercontent.com/alexgreensh/attention-span/main/output-styles/attention-kind.md프로젝트의 .claude/settings.local.json에 아래 항목을 추가한다. 기존 설정은 유지한다.
{ "outputStyle": "Attention-kind" }Claude Code를 다시 시작하면 새 스타일 파일을 읽는다. 모든 프로젝트에 적용하려면 파일을 ~/.claude/output-styles/에 두고 ~/.claude/settings.json에서 같은 이름을 선택한다.
스타일 정의: Attention-kind, Spartan, Rundown.
출처: alexgreensh/attention-span, Claude Code 출력 스타일 문서, Claude Code 플러그인 설치 문서