Claude Code 可以透過本機 Ollama 提供的模型處理獲授權的儲存庫。Ollama 目前的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 版本及 Claude Code CLI，並遵守裝置及組織規則。記錄 ollama --version及 claude --version。Ollama 在 2026 年 1 月的 0.14.0 版加入 Anthropic Messages 相容性；該日期不能確立目前 ollama launch指令的最低版本。

選擇目前目錄條目註明支援工具、授權允許使用，且模型權重與上下文配置都適合裝置的模型。一個具體本機例子是 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供程式代理使用，並說明更大上下文需要更多記憶體。硬體支援時，在既有 Ollama 應用程式的設定設為 64k 或更多。如果自行管理伺服器，應使用 OLLAMA_CONTEXT_LENGTH=64000並依各平台的伺服器說明設定既有服務，不要在 11434 連接埠啟動第二個伺服器。一次請求載入模型後，ollama ps會顯示實際的 CONTEXT及 PROCESSOR。若無法載入目標配置量，請停止，或縮小任務並選擇合適設定。不要把目錄最大值當成實際配置的上下文。

3. 將 Claude Code 路由至本機伺服器

開啟終端機，位置設在選定的儲存庫中。Ollama 記載以下啟動器方法；使用已透過 ollama list確認的同一本機標籤：

Text
ollama launch claude --model qwen3-coder:30b

Ollama 記載這種非 Claude 模型路徑。Anthropic 的閘道手冊則表示，Anthropic 不支援透過閘道將 Claude Code 路由到非 Claude 模型。請將它視為 Ollama 記載、但該路由不獲 Anthropic 支援的整合，並在依賴前檢查實際工作階段。

手動設定方面，Ollama 的整合說明改用 ANTHROPIC_AUTH_TOKEN=ollama、明確設為空值的 ANTHROPIC_API_KEY及 ANTHROPIC_BASE_URL=http://localhost:11434。下列可選的 Bash指令從獲授權儲存庫目錄執行，僅為這次 Claude Code 程序設定三項，不會改全域 shell 設定檔：

Terminal
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 的伺服器設定指引讓伺服器綁定本機。帶有 :cloud的標籤，或 https://ollama.com基礎 URL，是雲端路徑，涉及另一項資料及費用決策。模型或目的地不清楚時，請先暫停傳送儲存庫內容。

4. 先確認路由，再要求一次編輯

允許檔案修改前，如可用，請透過 /status查看 Claude Code 實際模型及連接。將結果與啟動器或手動端點、ollama list，以及請求載入模型後的 ollama ps比對。記錄載入的準確標籤、已配置的 CONTEXT及 PROCESSOR；分配到 CPU 的部分可能影響實際可用性。若有本機伺服器請求紀錄，也請查看。這些檢查確認設定及模型載入，不是完整的網路流量稽核。若程式政策要求本機處理，請另查啟用的 MCP 工具、網頁讀取與搜尋、遙測和雲端設定。

使用 Claude Code 正常授權提示及權限控制。用一般語言提出獲授權儲存庫的單一任務：需要的行為、允許範圍、原驗收指令和停止點。要求列出修改檔案及檢查輸出。commit、push、發布由儲存庫擁有者決定，拒絕意外網路或工具操作。模型聲稱用了本機端點或通過檢查，不等於已經驗證。

5. 依完整 diff 與原檢查作決定

查看每個修改檔案及完整 Git diff，包括超出要求範圍的變更。對照原行為及儲存庫政策，也檢查新相依套件授權。編輯後親自執行先前記錄的同一驗收指令，將結束狀態、相關輸出與初始狀態並列記錄。只有 diff 符合要求、獨立檢查結果可接受，且路由、權限證據滿足要求才接受。否則保持分支未被接受，留下準確失敗資訊供審查。

若無法連接 Ollama，先檢查執行中的應用程式或服務及 ollama list，再嘗試程式任務。模型無法載入，或 ollama ps指出上下文不足時，查看記憶體和上下文設定；縮小任務或選合適的本機模型。如果 /status或生效設定顯示託管供應商，請在傳送程式碼前停止，修復目前 shell 或 Claude Code 設定。工具呼叫錯誤可能來自模型相容性或權限拒絕，改動前先讀準確回應。若某次嘗試已修改檔案，還原或繼續前先看 diff。驗收失敗後診斷程式，只在修正經審查後再執行檢查。

下載模型的本機推論可避免供應商按 token 收取推論費用，但需要硬體、儲存空間及電力。下載、遙測、網頁工具、MCP 整合或雲端模型設定仍可能傳送資料或產生其他費用。Ollama 支援Anthropic Messages API 的一部分，但 token 計數、提示快取、批次、引用、PDF、強制工具選擇等功能有限制；模型的工具能力也有差異。BIG CHANGE 的文件審查沒有測得速度、品質、隱私或節省結果。其他本機代理設定可看我們的Junie Local 指南；此流程專門保留 Claude Code，並核對其 Ollama 路由。

資料來源與延伸閱讀