nicedreamzapp/claude-code-local

Claude Code Local – Mac で Anthropic スタイルのコーディング AI を実行

概要

• Claude Code が期待する Anthropic Messages API と同じインターフェースを持つ小型の Python サーバーですが、MLX ランタイムを介して Apple Silicon Mac 上で ローカル LLM を実行します。
• サーバーは、Gemma 4、Qwen 3.8、Llama-JSON などのモデルのツール呼び出し形式を Claude Code が理解できる形式に変換し、プロンプトをキャッシュして、エディタに応答をストリーミングします。

利点

• クラウドや API キーは不要で、ソースファイルがマシンから外部へ送信されることはありません。プライバシーを重視するコーディングに最適です。
• 16 GB の MacBook から 128 GB の M シリーズまで対応し、RAM に適したモデルを自動的に選択します。
• Claude Code のデフォルトのクラウドバックエンドをそのまま置き換えられるため、UI やワークフローは完全に同じままです。

主要コンポーネント

コンポーネント	役割
proxy/server.py	MLX ベースの推論サーバー。Anthropic 互換エンドポイントを実装し、ストリーミング、ツール呼び出し変換、プロンプトキャッシュの再利用を処理します。
agent/agent.py	軽量な「Native Engine」。短いシステムプロンプトを使用してターン間でキャッシュを維持する、単一ファイルのターミナルコーディングエージェントです。
bin/keepgoing*	前回の Claude Code セッションを検索し、Claude のクレジットが切れた際に無料のクラウドモデルや他のローカルモデルで継続できるようにします。
install.sh, setup.sh, scripts/doctor.sh	Mac のメモリを検出し、適切なモデル（Gemma 4 E4B、Hermes 4、Gemma 12/31B、Qwen 3.8 など）をダウンロードし、MLX Python 環境をインストールしてデスクトップランチャーを作成します。
launchers/	ローカルサーバーを指す Claude Code を起動するダブルクリック可能なスクリプト。Native Engine、ブラウザ駆動エージェント、音声モード、電話制御用のバリエーションも含まれます。

仕組み（概要）

エディタ (Claude Code) → http://localhost:4000 (本リポジトリのサーバー) への HTTP リクエスト →
MLX ランタイムが Apple GPU 上で選択されたモデルを実行 → Claude Code に応答をストリーミング

このサーバーは Claude Code の API を直接話すため、他の多くのローカル AI セットアップで使用される低速な「OpenAI スタイル」の変換器を回避します。

はじめに

1. ワンライナーインストーラーを実行します：

curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash

2. スクリプトが RAM に基づいてモデルを選択・ダウンロードし、デスクトップに Claude Local.command ショートカットを作成します。
3. ショートカットをダブルクリックして通常通り Claude Code を起動すると、AI の応答がローカルで生成されるようになります。

サポートされているモデル（自動選択されますが、変更も可能です）：

• Qwen 3.8 27B – 96 GB 以上の Mac に最適、8-bit MLX ビルド。
• Gemma 4 31B – 64-95 GB の Mac で高速。
• Gemma 4 12B – 32-63 GB の Mac に適合。
• Hermes 4 14B – 16 GB の Mac で動作。
• コミュニティ提供のビルド（Muse Glimmer、Nemotron 3 Nano Omni）も参考としてリストされています。

拡張機能

• 超高速なターミナル専用コーディングアシスタントには Native Engine ランチャーを使用してください。
• 作者の他のリポジトリ（Trinidad Head ターミナル、ブラウザエージェント、音声モード、電話制御）と組み合わせて、完全な「ローカルファースト」AI ワークステーションを構築できます。
• 別のローカルサーバーを好む場合は、README に Ollama、claude-code-router、claude-code-proxy などの代替案が記載されています。

プライバシーとセキュリティ

• すべてのトラフィックは localhost に限定されます。lsof でローカルポートのみが使用されていることを確認できます。
• 本プロジェクトは、環境フラグを介して Claude Code のバックグラウンドテレメトリとマーケットプレイスの自動インストールを無効にします。
• keep-going メニューから意図的に無料のクラウドモデルを選択しない限り、外部へのネットワーク呼び出しは行われません。

ライセンス

• MIT – 自由に修正、再配布、または独自のワークフローにサーバーを組み込むことができます。

結論 Claude Code Local は、Claude Code のコーディングアシスタント体験を維持しつつ、MLX を介して Apple Silicon の GPU を活用し、負荷の高い LLM 推論をデバイス上で実行します。これは、Anthropic スタイルのツールと、成長を続けるオープンソースのローカルモデルエコシステムとの間の、実用的でプライバシーを優先した架け橋です。