cc-stretch로 Claude Code 답변을 구문별로 읽기

cc-stretch의 기능

cc-stretch는 긴 답변을 더 쉽게 훑어볼 수 있게 해 주는 Claude Code 플러그인입니다. Claude는 처음에 답변의 짧은 버전을 보여 줍니다. 링크가 걸린 구문을 클릭하면 해당 구문이 추가 설명과 함께 제자리에서 확장됩니다. 다시 접으려면 «를 클릭하세요.

이미 읽은 텍스트는 같은 위치에 그대로 남습니다. 주변에 단어가 추가되므로, 읽던 위치를 잃지 않고 답변을 점진적으로 살펴볼 수 있습니다.

플러그인 설치

다음 명령어를 사용해 Claude Code 세션 안에서 cc-stretch를 설치하세요.

/plugin install cc-stretch --marketplace pro-vi/cc-stretch
/tui fullscreen

터미널에서 두 번째 명령어는 Claude Code를 전체 화면 렌더러로 전환합니다. 클릭 가능한 확장이 제대로 작동하려면 이 과정이 필요합니다. 명령어를 실행하면 세션이 다시 시작되고 재개됩니다.

Claude 데스크톱 앱에서는 확장이 자동으로 링크처럼 작동합니다. 확장을 클릭해 펼치고 «를 클릭해 닫으세요. 추가 설정은 필요하지 않습니다.

cc-stretch로 답변 읽기

1. 짧은 형식으로 시작하기

Claude가 답변을 보내면 cc-stretch는 먼저 짧은 버전을 표시합니다. README에서는 이를 모든 확장을 닫은 답변인 skim이라고 부릅니다.

2. 구문 확장하기

더 많은 맥락이 필요한 링크 구문을 클릭하세요. 이미 읽은 단어를 대체하지 않고 구문이 제자리에서 확장되며 세부 내용이 추가됩니다.

예를 들어 짧은 설명은 다음과 같이 시작할 수 있습니다.

모나드는 값을 감싸고, 각 단계가 감싼 값을 반환하도록 연결할 수 있게 하는 타입입니다.

문장을 확장하면 원래 표현을 유지하면서 더 자세한 내용을 제공할 수 있습니다.

프로그래밍에서 모나드는 값을 감싸는 제네릭 타입이며, 각 단계가 일반 값을 받아 감싼 값을 반환하도록 연결할 수 있게 해 줍니다. 단계 사이에서 직접 값을 풀 필요 없이 말이죠.

3. 세부 내용 접기

확장된 구문을 짧은 형식으로 줄이려면 «를 클릭하세요. 이를 통해 주의가 필요한 정도에 따라 빠른 개요와 더 깊은 설명 사이를 오갈 수 있습니다.

세 가지 읽기 수준 이해하기

cc-stretch는 답변을 다음 세 가지 용어로 설명합니다.

• Skim: 모든 확장을 닫은 답변입니다. 기본적으로 읽게 되는 내용입니다.
• Full: 모든 확장을 연 동일한 답변입니다. Claude가 작성한 모든 내용이 포함됩니다.
• Read: skim에 사용자가 연 확장을 결합한 내용입니다.

이 플러그인은 skim 버전과 full 버전 사이의 간극을 중심으로 설계되었습니다. 한 번에 한 구문씩 어떤 세부 내용에 주의를 기울일지 직접 결정할 수 있습니다. 이는 인터페이스만이 아니라 독자가 제어하는 점진적 공개 방식입니다.

주요 기능

• 중첩 확장: 더 길게 확장된 영역 안에 추가 세부 내용을 위한 확장이 포함될 수 있습니다.
• 깔끔한 스트리밍: Claude가 아직 답변을 생성하는 동안에도 이미 사용할 수 있는 확장은 짧은 형식으로 표시됩니다.
• 간결한 도구 호출: 완료된 도구 호출 그룹은 Ran 3 shell commands ▸ show와 같은 Claude Code 자체의 한 줄 요약으로 접힙니다.
• 실패와 진행 중인 작업 표시: 실행 중인 도구 호출과 오류가 발생한 호출은 접히지 않고 열린 상태로 유지됩니다.

터미널 및 데스크톱 동작

Claude Code의 터미널 전체 화면 레이아웃과 Claude 데스크톱 앱에서 클릭이 작동합니다. 다른 환경에서는 인터페이스가 텍스트를 숨기거나 업데이트할 수 없으므로 모든 확장이 열린 상태로 유지됩니다. 터미널의 기본 화면도 같은 제약이 있습니다. 출력된 답변은 표시된 후 변경할 수 없기 때문입니다.

첫 번째 답변이 완전히 확장된 상태로 표시되면 Claude Code가 전체 화면 모드로 실행 중인지 확인하세요. Claude Code 2.1.300부터는 전체 화면이 설정되어 있어도 일부 구성에서 기본 화면으로 시작할 수 있습니다. 여기에는 tmux -CC, Windows에서의 SSH 연결, 이전 전체 화면 시작이 실패한 시스템이 포함됩니다. 이러한 경우 다음 명령어로 Claude Code를 시작하세요.

CLAUDE_CODE_NO_FLICKER=1

Windows 사용자는 현재 클릭이 작동하지 않는다는 보고도 있다는 점에 유의하세요. 상태는 이슈 #1에서 확인할 수 있습니다.

중요한 제한 사항

• Claude는 답변의 모든 수준을 미리 작성합니다. 읽는 단어 수는 줄어들지만, 응답에는 플러그인이 없을 때와 대략 같은 수의 토큰이 사용됩니다.
• cc-stretch가 로드되지 않은 곳에서는 {{short|long}} 마크업이 원시 텍스트로 표시됩니다.
• 이 플러그인은 Claude Code의 얼리 액세스 function-hook 플러그인 API를 기반으로 하며, 릴리스에 따라 변경될 수 있습니다.
• Claude 데스크톱 앱에서는 cc-stretch의 도구 호출 접기가 표시되지 않습니다. 앱 자체의 도구 호출 표시 방식이 사용됩니다.
• 터미널 세션이 데스크톱 앱에도 연결되어 있으면 답변이 스트리밍되는 동안 마크업이 보일 수 있습니다. 데스크톱 앱은 해당 마크업을 바탕으로 링크를 만들기 때문입니다.

읽기량 감소에 대한 기대치

네 가지 코딩 프로젝트의 실제 답변 69개를 측정한 이 프로젝트의 결과에 따르면, 클릭하기 전에 표시되는 버전에는 플러그인 없이 Claude가 생성한 단어의 17%가 포함되었습니다. 가장 중요한 요점은 대략 세 개 중 두 개가 포함되었고, 나머지 세부 내용은 확장을 통해 확인할 수 있었습니다.

결과는 일반적으로 Claude의 답변이 얼마나 긴지에 따라 달라집니다. 답변이 이미 짧다면 cc-stretch로 절약되는 읽기 시간은 줄어듭니다. 저장소의 벤치마크 디렉터리에서는 측정 방법과 자체 대화 기록에서 측정을 실행하는 방법을 설명합니다.

개발 명령어

프로젝트를 작업 중이라면 저장소 설정에 따라 종속성을 설치한 다음 다음 명령어를 사용하세요.

npm test            # claude plugin validate . && claude plugin test .
npm run typecheck   # 벤치마크 스크립트

이 프로젝트에는 영화 제작 워크플로도 포함되어 있습니다. film/take.mjs 스크립트는 WezTerm 창에서 Claude Code를 실행하고 화면을 녹화하며, film/compose.mjs는 영상을 렌더링합니다. 영상에 사용된 보관 이미지의 출처와 라이선스 정보는 film/CREDITS.md에 정리되어 있습니다.

결론

cc-stretch는 Ted Nelson의 스트레치텍스트 아이디어를 Claude Code에 적용합니다. 간결한 답변으로 시작하고, 필요한 설명만 열어 본 다음, 읽던 위치를 잃지 않고 접을 수 있습니다. 플러그인을 설치하고, 필요할 때 터미널을 전체 화면으로 전환한 뒤, 연결된 문구를 사용해 Claude 답변에서 읽을 분량을 조절하세요.

배경과 구현 세부 정보는 cc-stretch 저장소를 방문하세요.