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

![Conceptual charcoal illustration of an open desktop workstation showing its fan, memory modules, graphics card and internal cables.](https://bigchange.ai/api/media/file/local-model-workstation-open-chassis-hero-v2.png)
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 個 token](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)則表示，Anthropic 不支援透過閘道將 Claude Code 路由到非 Claude 模型。請將它視為 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 程序設定三項，不會改全域 shell 設定檔：

```bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b
```

其他 shell 優先使用上述 Ollama 啟動器，或目前官方手冊的該 shell 設定。查看是否有會覆蓋指令變數的 Claude Code 既有設定，期間不要印出原有憑證。預期生效值是選定本機標籤及 `http://localhost:11434`；這是讀者要做的檢查，不是 BIG CHANGE 觀察到的結果。本機伺服器會忽略占位 token `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`或生效設定顯示託管供應商，請在傳送程式碼前停止，修復目前 shell 或 Claude Code 設定。工具呼叫錯誤可能來自模型相容性或權限拒絕，改動前先讀準確回應。若某次嘗試已修改檔案，還原或繼續前先看 diff。驗收失敗後診斷程式，只在修正經審查後再執行檢查。

下載模型的本機推論可避免供應商按 token 收取推論費用，但需要硬體、儲存空間及電力。下載、遙測、網頁工具、MCP 整合或雲端模型設定仍可能傳送資料或產生其他費用。Ollama 支援[Anthropic Messages API 的一部分](https://docs.ollama.com/api/anthropic-compatibility)，但 token 計數、提示快取、批次、引用、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)說明本機端點、忽略的占位 token、模型下載及 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)表示 Anthropic 不支援透過閘道把 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 端點、忽略的 token 占位符、模型下載及不支援功能。相容性因模型與工具而異。
- [上下文長度 — 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) — 官方安裝及啟動路徑；讀者須查目前平台說明與已安裝版本。
- [常見問題 — 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 記載的本機整合並存，不是法律結論。