Claude Code의 터미널 깜빡임 버그: 700개 이상의 추천, 9개월, 여전히 미해결

    /
    4 분 소요
    Ing. Patrik Kelemen
    Claude Code의 터미널 깜빡임 버그: 700개 이상의 추천, 9개월, 여전히 미해결

    Claude Code에는 IDE를 충돌시키고 제어 불가능한 스크롤을 유발하는 치명적인 터미널 깜빡임 버그가 있습니다. 2025년 3월 이후 700개 이상의 추천을 받았지만, Anthropic은 여전히 수정 사항을 배포하지 않았습니다.

    Namiru AI

    AI 고객 지원 당신의 웹사이트를 위한

    URL을 붙여넣으세요. 30초 만에 지원 에이전트를 받으세요.

    Claude Code의 터미널 깜빡임 버그: 700개 이상의 추천, 9개월, 여전히 미해결

    Claude Code에는 IDE 전체를 충돌시키고, 시스템을 사용 불가능하게 만들며, 광과민성 사용자에게 발작을 유발할 수 있을 정도로 심각한 터미널 렌더링 문제가 있습니다. 이 버그는 2025년 3월부터 문서화되었습니다. 여러 이슈에 걸쳐 1000개 이상의 추천을 받았습니다. 그리고 2025년 12월 현재, 여전히 수정되지 않았습니다.

    이 재앙의 규모

    터미널 스크롤이 완전히 제어 불능 상태가 되는 것을 문서화한 이슈 #3648은 282개의 좋아요 반응을 받았습니다. 이슈 #1913은 181개의 좋아요를 받았습니다. 2025년 4월의 이슈 #769는 168개의 좋아요를 받았습니다. 저장소 전체에 흩어져 있는 중복 이슈가 최소 12개 이상 있으며, 모두 동일한 근본적인 문제를 설명하고 있습니다.

    1000명 이상의 개발자가 같은 버그에 대해 외치고 있다는 것은 사소한 문제가 아닙니다. 이것은 시스템적 실패입니다.

    한 개발자가 실제로 Claude Code가 터미널에 무엇을 하는지 측정했습니다. 이슈 #9935의 발견 사항은 정말 충격적입니다: 초당 4,000에서 6,700개의 스크롤 이벤트. 근본 원인은 Claude Code가 합리적인 터미널 애플리케이션처럼 증분 업데이트를 수행하는 대신 스트리밍 출력의 모든 청크마다 전체 터미널을 다시 그린다는 것입니다.

    사용자가 경험하는 것

    실제 모습 보기: [원본 버그 리포트]에는 정상 사용 중 터미널이 스트로브 라이트로 변하는 영상이 포함되어 있습니다.

    VS Code와 Cursor에서는 터미널이 깜빡이기 시작하고, 점점 악화되다가, 10~20분 후 전체 에디터가 멈추고 충돌합니다. 저장하지 않은 모든 작업이 함께 사라집니다.

    독립 실행형 터미널에서는 충돌 없이 스트로브 라이트 효과를 경험합니다. 이전 대화 기록이 새 출력과 섞여 깜빡입니다. 스크롤바가 불규칙하게 점프합니다. Claude가 생각하는 동안 타이핑하는 것은 좌절감을 주는 경험입니다.

    터미널이 스스로 초고속으로 스크롤하기 시작하며, 터미널 탭을 종료하고 Claude를 재시작하지 않으면 멈출 수 없는 경우가 많습니다. 프롬프트를 입력하려고 할 때 입력 위치를 찾기 위해 반복적으로 아래로 스크롤해야 하는 경우도 있습니다.

    일부 사용자는 이 버그가 최대 7개의 병렬 Claude Code 프로세스를 생성하며, 각각이 CPU를 소비하면서 터미널이 끝없이 깜빡이고 응답이 없다고 보고합니다.

    접근성 문제

    원본 버그 리포트는 이것을 명시적으로 접근성 문제로 표시했습니다. 빠른 화면 깜빡임은 광과민성 간질의 알려진 유발 요인입니다. 웹 콘텐츠 접근성 지침은 초당 3회 이상 깜빡이는 콘텐츠에 대해 경고합니다. Claude Code는 초당 수천 번 깜빡입니다.

    Anthropic은 AI 안전에 깊이 전념한다고 홍보하지만, 9개월 동안 알려진 접근성 위험이 있는 제품을 출시했습니다.

    왜 이것은 쉽게 고칠 수 있어야 하는가

    이것은 깊은 아키텍처 문제가 아닙니다. 수정 방법은 개념적으로 간단합니다: 모든 업데이트마다 전체 터미널 버퍼를 다시 그리는 것을 중단하세요. 커서 위치 지정을 사용하여 변경된 부분만 업데이트하세요. 이것은 1970년대부터 이해된 기본적인 터미널 프로그래밍입니다.

    화려한 시각적 인터페이스가 점진적으로 렌더링하기에 너무 복잡하다면, 단순화하세요. IDE를 충돌시키는 예쁜 인터페이스보다 작동하는 일반 텍스트 모드를 사용자에게 제공하세요.

    수정될 때까지 생존하는 방법

    커뮤니티 발견 사항을 기반으로 한 최선의 해결 방법은 다음과 같습니다:

    Mac 사용자의 경우, IDE 터미널을 완전히 버리세요. 네이티브 Terminal.app이나 iTerm2와 같은 간단한 독립 실행형 bash 터미널을 사용하세요. 깜빡임은 여전히 발생하지만 최소한 전체 개발 환경을 충돌시키지는 않습니다.

    터미널 설정에서 터미널 스크롤백을 500줄 이하로 줄이세요. 이것은 버그를 수정하지는 않지만 심각도를 줄입니다.

    프롬프트 사이에 /clear를 자주 사용하여 버퍼를 재설정하세요. 이것은 최종 붕괴를 지연시키지만 방지하지는 못합니다.

    Claude Code 세션에서 VS Code와 Cursor 통합 터미널을 완전히 피하세요. 외부 터미널이 남용을 더 잘 처리합니다.

    세션을 짧게 유지하세요. 서브에이전트를 사용한 무거운 에이전트 작업을 수행하는 경우, 깜빡임이 악화될 것으로 예상하세요. 충돌하기 전에 재시작하세요.

    해당 옵션이 있는 경우 터미널에서 GPU 가속 및 부드러운 스크롤을 비활성화하세요.

    결론: 9개월, 700개 이상의 추천, 초당 6,700개의 스크롤 이벤트, 수정 없음. 해결 방법을 사용하고, 인내심을 유지하며, 더미에 추천을 추가하세요.


    관련 GitHub 이슈

    제작 Namiru.ai - 웹사이트를 위한 플러그앤플레이 AI 채팅.

    Patrik Kelemen
    Author
    Ing. Patrik Kelemen
    Founder of Namiru.aiSlovakia, EU

    Senior software engineer with 10+ years of experience, specializing in AI chat widgets and automation. Building Namiru.ai to help businesses leverage AI without complexity.

    AI AgentsAngularReactNodeJSAWSAzure
    이 기사가 도움이 되셨나요?

    AI가 당신의 웹사이트

    URL을 붙여넣고 AI 에이전트가 몇 초 만에 활성화되는 것을 확인하세요.

    고객은 즉각적인 답변을 받고, 당신은 리드, 분석, 그리고 시간을 되찾습니다.

    신용카드 불필요

    Namiru.ai

    AI chat for your website