sadjow/claude-code-nix

해결하는 문제

이 프로젝트는 Claude Code용 Nix 패키지를 제공합니다. Claude Code는 터미널용 AI 코드 보조 도구입니다. 공식 Nixpkgs 업데이트가 느리고, 전역 npm 설치는 선언적이지 않으며 재현 불가능하고 Node.js 버전을 전환할 때 사라지기 때문에 Nix 사용자들이 도구를 최신 상태로 유지하는 문제를 해결합니다.

작동 방식

이 리포지토리는 GitHub Actions를 사용하여 매시간 새로운 Claude Code 버전을 확인합니다. 새로운 버전이 감지되면 자동으로 패키지를 업데이트하고, 네이티브 바이너리의 해시를 계산하며, 결과를 Cachix에 캐시하여 즉시 설치할 수 있도록 합니다. Anthropic에서 제공하는 자체 포함형 네이티브 바이너리를 패키지화하여 런타임 종속성이 없고 다양한 Node.js 환경에서 작동하도록 보장합니다.

대상 사용자

최신 릴리스에 항상 최신 상태로 유지되며, 메인 Nixpkgs 리포지토리의 업데이트를 기다리지 않고, 선언적이고 재현 가능한 Claude Code 설치를 원하는 NixOS 및 Home Manager 사용자들입니다.

주요 특징

• 시간당 업데이트: 자동 확인을 통해 릴리스 후 1시간 이내에 새로운 버전을 이용할 수 있습니다.
• 네이티브 바이너리: 외부 런타임 종속성이 없는 자체 포함형 바이너리 (~180MB)를 포함합니다.
• 바이너리 캐시: Cachix와의 통합으로 로컬 컴파일 없이 빠른 설치가 가능합니다.
• 버전 고정: 정확한 버전 태그 (예: v2.1.71) 또는 이동 채널을 지원하여 유연한 업데이트 제어가 가능합니다.
• 선언적 구성: NixOS 및 Home Manager와 완전 호환되어 시스템 전체 또는 사용자별 구성이 가능합니다.