Claude Code를 조용하게 만드는 2줄짜리 플러그인을 출시했습니다

켜두는 동안 Claude Code는 5줄 이하로 답변합니다 — 끌 때까지 말이죠. 오픈 소스이며 MIT 라이선스입니다.

Claude Code는 훌륭합니다. 하지만 수다스럽기도 하죠. 간단한 질문을 던졌는데 세 단락의 설명, 요약, 그리고 필요하지도 않은 "좋은 질문입니다!"라는 말까지 돌아옵니다. 하루에도 수십 번씩 긴 터미널 출력(terminal output)을 읽는 것은 정말 피곤한 일입니다.

그래서 저는 지속적인 **ON/OFF 간결 모드 (brevity mode)**를 추가하는 아주 작은 플러그인인 **tldr**을 만들었습니다.

문제점

장황함(Verbosity)이 기본값인 데에는 이유가 있습니다. 사용자가 무엇을 필요로 하는지 모를 때는 더 많은 문맥(context)을 제공하는 것이 더 안전하기 때문입니다. 하지만 당신이 정확히 무엇을 원하는지 알게 되는 순간, 그 안전장치는 소음이 됩니다. 그리고 매번 "간결하게 말해줘"라고 잔소리하는 것은 효과가 없습니다. 모델은 몇 메시지 지나지 않아 다시 긴 형식으로 돌아가 버리기 때문입니다.

저는 간청이 아니라 스위치를 원했습니다.

설치 (2줄)

어떤 Claude Code 세션에서든 다음과 같이 입력하세요:

/plugin marketplace add rodrigooler/claude-code-tldr
/plugin install tldr@claude-code-tldr

그 다음 그냥 /tldr (또는 "short mode", "be brief")이라고 말하면 됩니다. 다시 돌아가려면 /tldr off라고 하세요.

전 / 후

전 (기본값):

좋은 질문입니다! 이에 대해 차근차근 설명해 드리겠습니다. 여기서 고려해야 할 몇 가지 사항이 있습니다. 우선, 캐시는 ~/.cache에 저장되며, 크기가 커지는 이유는... (12줄 더 있음) ... 요약하자면, `cache clear`를 실행하세요.

후 (tldr ON):

실행: cache clear
캐시는 ~/.cache에 저장되며, 정리 작업이 없어서 크기가 커집니다.

답변은 같습니다. 읽어야 할 양은 10분의 1로 줄었습니다.

작동 원리

제가 가장 좋아하는 부분입니다. MCP 서버도, 백그라운드 프로세스도, 텔레메트리(telemetry)도 없습니다. tldr은 단 하나의 Skill입니다. 모드를 전환할 때 Claude가 로드하는 행동 규칙이 담긴 단 하나의 SKILL.md 파일일 뿐입니다. 이 "제품"의 전체 실체는 프롬프트(prompt)입니다.

활성화(ON) 상태일 때 이 플러그인은 다음을 강제합니다: 최대 3~5줄, 결과 + 다음 단계만 제공, 불필요한 미사여구(filler) 제외, 짧은 불렛 포인트(bullets). 또한 가드레일(guardrails)이 설정되어 있어, 사용자가 붙여넣거나 실행할 코드와 보안 경고는 절대 생략되지 않으며, 그 주변의 잡담(chatter)만 생략됩니다. 실제적인 결정을 내려야 할 때는 5줄 이내로 판결을 내리고, 전체 세부 정보를 보려면 expand 명령을 제공합니다.

지속성(persistence)이 핵심 비결입니다. 이것은 일회성이 아니라 하나의 모드(mode)입니다. 사용자가 끄기 전까지는 여러 턴(turns)에 걸쳐 계속 유지됩니다.

플러그인으로 출시하며 배운 점

1. 가장 작고 유용한 것은 아주 작아도 괜찮습니다. 하나의 마크다운(Markdown) 파일이라도 실제 마찰(friction)을 제거할 수 있다면 정당한 제품이 됩니다.
2. 배포는 플러그인 매니페스트(plugin manifest)입니다. 유효한 marketplace.json + plugin.json이 있다면 개인의 기술을 누구나 2줄 만에 설치할 수 있는 것으로 바꿀 수 있습니다.
3. 파일이 아닌 실제 흐름을 검증하세요. 저는 발표하기 전에 GitHub에서 일회용 설정 디렉토리(CLAUDE_CONFIG_DIR)로 이를 설치해 보았습니다. 매니페스트(manifests) 검증을 통과하는 것과 설치가 실제로 작동하는 것은 별개의 문제입니다.

사용해 보기

무료이며 MIT 라이선스입니다. 스크롤을 줄이는 데 도움이 되었다면, 더 많은 작업을 할 수 있도록 ⭐(Star)를 눌러주세요:
https://github.com/rodrigooler/claude-code-tldr

다음에는 어떤 Claude Code 스킬을 만들어볼까요? 댓글로 알려주세요.