Claude Code 패치
이 기능이 하는 일
본 저장소는 출력을 더 투명하게 만들기 위해 패치된 네이티브 Claude 바이너리를 게시합니다. 상세한 변경 사항 목록은 다음과 같습니다:
- 축소된 요약 대신 상세한 도구 호출(tool calls)을 표시합니다.
- 스피너 팁(spinner tips) 기능을 강제로 비활성화합니다.
- 추론 과정(thinking)을 UI에서 실시간 스트리밍합니다. 이는 Claude가 10분 이상 생각하는 경우, 실제로 작업 중인지 여부를 알고 싶을 때 유용합니다.
- 상세 모드가 아닌(non-verbose) UI에서도 서브 에이전트의
Prompt: 블록을 표시합니다.
- 시작 헤더 이름을
Connoisseur's Code v...로 변경합니다.
- 이 저장소의 패치된 릴리스에서 자동 및 수동 업데이트를 다운로드합니다.
추론 참고 사항:
- 패치된 바이너리는 요약된 추론 과정을 자동으로 요청합니다. Claude 설정에서
showThinkingSummaries를 활성화할 필요가 없습니다.
빠른 시작
전제 조건
만약 npm을 통해 Claude Code를 설치했다면, 먼저 제거한 후 네이티브 빌드를 설치해야 합니다:
npm uninstall -g @anthropic-ai/claude-code
curl -fsSL https://claude.ai/install.sh | bash
claude --version
자동 설치
이 설치 프로그램은 사용자의 OS와 CPU 아키텍처를 감지하여 해당 플랫폼에 맞는 최신 패치된 릴리스를 다운로드합니다.
설치된 Claude 버전이 패치된 릴리스와 일치할 필요는 없습니다.
curl -fsSL https://raw.githubusercontent.com/a-connoisseur/patch-claude-code/main/install-patched-claude.sh | bash
Windows에서는 PowerShell을 사용하십시오:
ir https://raw.githubusercontent.com/a-connoisseur/patch-claude-code/main/install-patched-claude.ps1 | iex
설치 후에는 자동 업데이트와 claude update가 이 저장소의 패치된 릴리스를 사용합니다. Claude는 더 새로운 패치된 릴리스가 이용 가능할 때까지 현재 패치된 빌드를 유지합니다.
업데이트 프로그램은 설치 전에 각 다운로드의 SHA-256 체크섬과 패치 버전 마커를 확인합니다.
절대 공식적인 미패치 바이너리를 업데이트로 다운로드하지 않습니다.
‘latest’와 ‘stable’ 채널 모두 사용자의 플랫폼에 맞는 최신 패치된 릴리스를 사용합니다.
자동 업데이트는 Claude의 기존 일정을 유지하며, DISABLE_AUTOUPDATER 및 DISABLE_UPDATES 설정을 존중합니다.
이전에 자동 업데이트를 비활성화했다면, 다시 활성화하려면 해당 설정을 제거하십시오.
이전 패치된 바이너리는 새 업데이터를 받기 위해 설치 프로그램 실행이 한 번 필요합니다.
인터넷에서 스크립트를 무작정 실행하는 것을 피하고 싶다면, 아래의 수동 방식을 사용할 수 있습니다. 다만, 이 바이너리들은 Github Actions를 기반으로 빌드되었고 패처 역시 사용자가 확인하고 수정할 수 있도록 공개되어 있으므로, 편리함을 제외하고는 이 저장소(repo)나 릴리스 빌드를 신뢰할 이유가 없습니다.
수동 설치 (릴리스에서 다운로드, 네이티브 전용)
-
사용자의 플랫폼에 맞는 릴리스 태그를 선택합니다:
- macOS arm64:
macos-arm64
- Linux x64:
linux-x64
- Linux arm64:
linux-arm64
- Windows x64:
win32-x64
- Windows arm64:
win32-arm64
-
해당 릴리스에서 사용자의 플랫폼에 맞는 일반 패치된 바이너리를 다운로드합니다.
-
아래의 플랫폼별 설치 지침을 따릅니다.
설치 (Linux)
chmod +x ./claude.native.patched
target="$(python3 -c 'import os,sys; print(os.path.realpath(sys.argv[1]))' "$(command -v claude)")"
sudo mv ./claude.native.patched "$target"
...
설치 (macOS)
chmod +x ./claude.native.macos.patched
target="$(python3 -c 'import os,sys; print(os.path.realpath(sys.argv[1]))' "$(command -v claude)")"
sudo mv ./claude.native.macos.patched "$target"
...
Linux 및 macOS 명령어는 업데이터가 새 버전을 활성화할 수 있도록 네이티브 런처 심볼릭 링크(symlink)를 유지합니다.
설치 (Windows)
$target = (Get-Command claude).Source
Copy-Item . extbackslash claude.native.windows.patched.exe $target -Force
claude --version