概要
Raspberry Pi 5にNixOSを導入し、Claude Codeを常時稼働させるための宣言的な構成管理と具体的なセットアップ手順の解説。
詳細内容
Raspberry Pi 5を低消費電力なClaude Code専用のエージェント実行環境として構築するガイドです。主な技術スタックとしてNixOSを採用し、システム全体をコードで定義することで、SDカードの故障時にも即座に復旧可能な再現性を確保しています。
主な構成要素は以下の通りです：
- **クロスビルド環境**: Apple Silicon Mac上のDocker（Linuxビルダー）を使用してaarch64-linuxイメージをビルドするフロー。
- **システムの自動化**: 起動時にGitHubから最新コードをプルする `git-pull-on-boot` サービスや、公式ケースのファン制御を含むハードウェア設定の記述。
- **Claude Codeの常駐化**: headless環境に適した `claude remote-control` モードをsystemdサービスとして定義。外部（スマホやWeb）から常時アクセス可能なAIエージェント環境を実現しています。
- **実運用のノウハウ**: RTCを持たないPi特有の時刻同期待ち処理や、ベンダーカーネルとDTBの整合性確保など、実機特有のハマりどころをカバーしています。
メインマシンのスリープに依存せず、セキュアに隔離された環境でAIエージェントを運用したいユーザーにとって、極めて実用的な構成案となっています。