Markdown版
AI-translated from English; not yet reviewed by a fluent editor.
# ローカル Ollama モデルで Claude Code の変更を一つ実行し、検証する
> Claude Code をローカル Ollama モデルへ接続し、エンドポイントとコンテキストを確認してから、元の受け入れチェックで一つのリポジトリ変更を評価する、文書に基づく手順です。
By BIG CHANGE Editorial
Published: 2026-10-20T11:36:37.990Z
Updated: 2026-10-20T11:36:37.990Z
Canonical: https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide

AI-generated conceptual illustration by BIG CHANGE.
Claude Code は、端末上の Ollama が提供するモデルを通じて、権限のあるリポジトリを扱えます。Ollama の現在の[Claude Code 連携](https://docs.ollama.com/integrations/claude-code)は Anthropic 互換 API に直接接続します。本ガイドでは範囲を限定した変更を、初期状態の記録から人による diff の判断まで進めます。両ツールを導入し、リポジトリの編集を許可でき、適切なローカルコーディングモデルを動かせる開発者向けです。BIG CHANGE は 2026 年 10 月 20 日にマニュアルを確認しましたが、モデルやリポジトリのテストは実行していません。
## 大きな変化
- **変わったこと:**Ollama は Claude Code をローカルの Anthropic 互換サーバーへ直接接続する方法を文書化しており、ランチャーまたは明示的なローカル接続設定を使えます。この文書化された構成に別のプロキシは不要です。
- **重要な理由:**Claude Code の作業方法を維持しつつローカルモデルを選択し、実際のコンテキスト割り当てを確認して、元の受け入れチェックに照らしてリポジトリ変更を評価できます。
- **注意すること:**ローカルタグの選択とモデル稼働だけでは、全リクエストがローカルだったことやコードの正しさは証明できません。変更を受け入れる前に、実効ルーティング、ツール権限、全 diff、確認結果を調べます。
### 1. リポジトリの開始状態を記録する
所有するか変更許可のある Git リポジトリを使います。レビュー可能なブランチか使い捨て作業コピーを選びます。変更する小さな動作または不具合、対象ファイル、停止条件を指定します。文書化されたテストやビルドなど既存の受け入れコマンドを見つけ、一般的なコマンドで代用しないでください。エージェントの編集**前**に実行し、コマンド、終了状態、関連出力を残します。ブランチ、`git status`、既存 diff も記録します。以前からの変更は初期状態であり、AI の成果ではありません。
組織のコードと依存関係の方針が選んだモデルとツールを許可するか確認します。Claude Code は有効な権限設定に従いファイルを読み、コマンドを実行できます。「このファイルだけ変更する」という依頼は誘導にはなりますが、ファイルシステムへのアクセス制限にはなりません。
### 2. 適切なローカルモデルを導入し、コンテキストを割り当てる
公式手順に従い、端末と組織の規則の範囲で現在の [Ollama リリース](https://docs.ollama.com/quickstart)と [Claude Code CLI](https://code.claude.com/docs/en/setup)を導入します。`ollama --version`と `claude --version`を記録します。Ollama は 2026 年 1 月の 0.14.0 で Anthropic Messages 互換性を追加しましたが、その日付は現行ランチャーの最低バージョンを**示すものではありません**。現在の `ollama launch`コマンドの要件は別途確認します。
現在のモデル一覧にツール対応があり、ライセンスが利用を許可し、重み**とコンテキスト割り当て**が端末に収まるモデルを選びます。具体的なローカル例は [qwen3-coder:30b](https://ollama.com/library/qwen3-coder:30b)で、ツール対応、約 19 GB の Q4\_K\_M ファイル、Apache License 2.0 が掲載されています。これはダウンロード容量であり RAM や VRAM の要件ではありません。広告されるコンテキスト長を端末で割り当てられるとは限りません。適さなければ、文書でツール対応を確認できる別のローカルタグを選び、以下の全コマンドで一貫して置き換えます。
Ollama アプリまたはローカルサーバーの起動後、端末で正確なタグをダウンロードして確認します。
```text
ollama pull qwen3-coder:30b
ollama list
```
Ollama は [少なくとも 64,000 トークンを推奨](https://docs.ollama.com/context-length)し、コーディングエージェントでコンテキストを増やすとメモリー使用量が増えると説明しています。ハードウェアが対応するなら、**既存 Ollama アプリの設定**で 64k 以上にします。自分でサーバーを管理する場合は既存サービスを `OLLAMA_CONTEXT_LENGTH=64000` で設定し、[プラットフォーム別サーバー手順](https://docs.ollama.com/context-length)に従います。ポート 11434 に二つ目を起動してはいけません。リクエストでモデルが読み込まれた後、`ollama ps`に実際の `CONTEXT`と `PROCESSOR`が表示されます。意図した割り当てを読み込めなければ停止するか、作業範囲を減らして適切な構成を選びます。一覧の最大値を割り当て済みコンテキストとして報告しないでください。
### 3. Claude Code をローカルサーバーへ向ける
端末を開く場所は**選んだリポジトリ内**です。Ollama は以下のランチャー方式を文書化しています。`ollama list`で確認した同じローカルタグを使います。
```text
ollama launch claude --model qwen3-coder:30b
```
Ollama はこの Claude 以外のモデルへの経路を説明しています。[Anthropic のゲートウェイマニュアル](https://code.claude.com/docs/en/llm-gateway)は、ゲートウェイ経由で Claude Code を非 Claude モデルへ向けることを Anthropic はサポートしないと記しています。Ollama が文書化し、Anthropic はそのルーティングをサポートしない連携として扱い、依存する前に実際のセッションを確認します。
手動設定では、Ollama の[連携手順](https://docs.ollama.com/integrations/claude-code#manual-setup)が代わりに `ANTHROPIC_AUTH_TOKEN=ollama`、明示的に空の `ANTHROPIC_API_KEY`、および `ANTHROPIC_BASE_URL=http://localhost:11434`を使います。この任意の **Bash**コマンドは、許可されたリポジトリ内からこの Claude Code プロセスだけに三つの値を設定し、グローバルなシェル設定は変えません。
```bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b
```
他のシェルでは、上の Ollama ランチャーを優先するか、現在の公式手順でシェル別設定を確認します。コマンドの変数を上書きする既存の Claude Code 設定がないか調べ、既存の認証情報は表示しないでください。想定する実効値は選んだローカルタグと `http://localhost:11434`です。読者が確かめる項目であり、BIG CHANGE が観測した結果ではありません。ローカルサーバーは仮のトークン `ollama`を無視し、これはアクセス制御用の秘密ではありません。この文書上のローカル経路に Ollama クラウドキーや Anthropic 推論キーは不要です。Claude Code ソフトウェアと接続サービスの条件は引き続き適用されます。
Ollama の[サーバー設定ガイド](https://docs.ollama.com/faq)に従いサーバーをローカルにバインドします。`:cloud`タグ、または `https://ollama.com`のベース URL はクラウド経路であり、データと費用について別の判断が必要です。モデルや宛先が不明なら、リポジトリ内容を送る前に停止します。
### 4. 経路を確認してから、一つの編集を依頼する
ファイル変更を許可する前に、利用できる場合は `/status`で Claude Code の実効モデルと接続を確認します。ランチャーまたは手動接続先、`ollama list`、リクエストでモデルを読み込んだ後の `ollama ps`と比較します。読み込まれた正確なタグ、割り当て済みの `CONTEXT`と `PROCESSOR`を記録します。CPU に分散されると実用性が変わる場合があります。利用できるならローカルサーバーのリクエスト記録も調べます。これらは設定とモデル読み込みの確認であり、全ネットワーク通信の監査ではありません。ローカル処理がコード方針上重要なら、MCP ツール、ウェブ取得と検索、テレメトリー、クラウド設定を別途確認します。
Claude Code の通常の許可要求と[権限制御](https://code.claude.com/docs/en/permissions)を使います。必要な動作、許可範囲、元の受け入れコマンド、停止点を普通の言葉で示し、権限のあるリポジトリの単一作業を依頼します。変更ファイルと確認出力の報告も求めます。commit、push、リリースは所有者が判断し、想定外のネットワークやツール操作は断ります。モデルがローカル接続や検査成功を主張しても検証にはなりません。
### 5. 全 diff と元の確認から判断する
変更した全ファイルと**Git diff 全体**を調べ、依頼範囲外の変更も確認します。元の動作とリポジトリ方針に照らし、新規依存関係のライセンスも確認します。編集後に自分で同じ受け入れコマンドを実行し、終了状態と関連出力を初期結果と並べて記録します。diff が要求に合い、独立確認が許容でき、ルーティングと権限の証拠が要件を満たす場合だけ受け入れます。それ以外は未受け入れのまま、正確な失敗をレビュー用に残します。
Ollama に接続できなければ、実行中のアプリまたはサービスと `ollama list`をコーディング作業前に確認します。モデルが読み込めない、または `ollama ps`がコンテキスト不足を示すなら、メモリーと設定を調べ、作業を小さくするか適切なローカルモデルを使います。`/status`や実効設定がホスト型プロバイダーを示すなら、コード送信前に停止して現在のシェルや Claude Code 設定を修正します。ツール呼び出しエラーはモデル互換性か権限拒否が原因かもしれないので、変更前に正確な応答を確認します。試行でファイルが変わっていれば、戻すか続ける前に diff を見ます。受け入れチェック失敗後はコードを診断し、レビューした修正後にだけ再確認します。
ダウンロード済みモデルのローカル推論はプロバイダーのトークン単位推論料金を避けられますが、機器、保存領域、電力を使います。ダウンロード、テレメトリー、ウェブツール、MCP 連携、クラウドモデル設定はデータを送ったり他の費用を生じさせたりします。Ollama が対応するのは[Anthropic Messages API の一部](https://docs.ollama.com/api/anthropic-compatibility)で、トークン計数、プロンプトキャッシュ、バッチ、引用、PDF、強制ツール選択などに制限があります。ツール能力もモデルごとに違います。BIG CHANGE の文書確認には速度、品質、プライバシー、節約の測定結果はありません。別のローカルエージェント構成は当社の[Junie Local ガイド](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup)を参照してください。この手順は Claude Code を維持し、Ollama への経路を確認します。
## 出典・関連資料
- [Ollama「Claude Code」](https://docs.ollama.com/integrations/claude-code)は現在のランチャー、手動ローカル設定、クラウド代替を示します。読者のリポジトリで成功した実行の証明ではありません。
- [Ollama「Anthropic 互換性」](https://docs.ollama.com/api/anthropic-compatibility)はローカル接続先、無視する仮トークン、モデル取得、API 制限を説明します。互換性は全モデルやツール呼び出しの認証ではありません。
- [Ollama「コンテキスト長」](https://docs.ollama.com/context-length)はコーディングの 64k 推奨、メモリーとの兼ね合い、`ollama ps`による読み取り確認を説明します。実際の機器が可能な割り当てを決めます。
- [Ollama の qwen3-coder:30b 項目](https://ollama.com/library/qwen3-coder:30b)は例のファイル、ツール、Apache 2.0 のリンクを示します。取得や再配布前に正確な項目を再確認します。
- [Claude Code の導入](https://code.claude.com/docs/en/setup)と[権限設定](https://code.claude.com/docs/en/permissions)はアクセスとツール許可を説明します。特定セッションの実効接続先や安全なリポジトリ結果を証明するものではありません。
- [Anthropic「その他の LLM ゲートウェイ」](https://code.claude.com/docs/en/llm-gateway)は Claude Code をゲートウェイ経由で非 Claude モデルへ向けることをサポートしないと説明します。Ollama は本ガイドのローカル連携を別途文書化しています。
## Sources
- [Claude Code — Ollama](https://docs.ollama.com/integrations/claude-code) — ランチャーと手動ローカル接続先、および独立したクラウド経路の一次資料です。特定の実行が localhost を使った証明ではありません。
- [Anthropic 互換性 — Ollama](https://docs.ollama.com/api/anthropic-compatibility) — ローカル Messages 接続先、無視するトークン、モデル取得、非対応機能の説明です。互換性はモデルとツール次第です。
- [コンテキスト長 — Ollama](https://docs.ollama.com/context-length) — コーディングの 64k 推奨、メモリーとの兼ね合い、ollama ps のコンテキスト・プロセッサー確認です。特定機器の容量保証はありません。
- [qwen3-coder:30b — Ollama モデルライブラリ](https://ollama.com/library/qwen3-coder:30b) — 正確なローカル例タグ、ツール、約 19 GB の Q4_K_M、Apache 2.0 リンクです。取得サイズは作業メモリー要件ではありません。
- [クイックスタート — Ollama](https://docs.ollama.com/quickstart) — 公式の導入・開始方法です。現在のプラットフォーム手順と導入済みバージョンを確認します。
- [FAQ — Ollama](https://docs.ollama.com/faq) — ローカルサーバー設定とネットワーク・クラウドの境界です。Claude Code や連携の完全なプライバシー監査ではありません。
- [Claude Code 対応 — Ollama](https://ollama.com/blog/claude) — Messages 互換性を v0.14.0 に位置づけますが、現在のランチャーの最低バージョンは確定しません。
- [高度な設定 — Claude Code Docs](https://code.claude.com/docs/en/setup) — 公式の導入とプラットフォーム要件です。本記事のために Claude Code を導入・実行していません。
- [権限の設定 — Claude Code Docs](https://code.claude.com/docs/en/permissions) — ツール許可と実効権限です。普通の言葉で指定するパスはサンドボックスではありません。
- [その他の LLM ゲートウェイ — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — Anthropic はゲートウェイ経由で Claude Code を非 Claude モデルへ向けることをサポートしないとしています。Ollama が文書化するローカル連携と併存する提供元のサポート境界であり、法的結論ではありません。
BIG CHANGEニュースレター
大局を、あなたのペースで。
AI とロボティクスの最新記事、注目すべき変化、活用できる実用的なアイデア。日刊ブリーフィング、週刊ダイジェスト、月刊展望から選べます。
次回の配信予定(UTC): . 確認後、次回の配信予定時刻に最初のニュースレターが届きます。