告別昂貴 API：我如何透過 Ollama 本地化部署 Claude Code

身為一名長期關注人工智能發展的開發者，筆者近年最深的體會莫過於「工具雖好，但錢包很痛」。自從 Anthropic 推出了強大的終端機工具 Claude Code 後，其卓越的代碼理解與自動化執行能力確實令開發流程縮短了不少。然而，頻繁調用 API 所產生的費用，以及在香港使用時常遇到的網絡延誤與帳號限制，始終是揮之不去的痛點。

最近，筆者在技術社群中留意到一個名為 CC Switch 的開源項目，聲稱可以讓 Claude Code 脫離雲端，直接運行在本地的開源模型上。經過幾天的深度實測，我成功將這套方案部署在我的開發環境中，現在就為大家分享這次從「付費依賴」轉向「本地自主」的實戰經驗。

為何我們需要將 Claude Code 本地化？

在進入技術細節前，我們先聊聊實踐感。傳統上，使用 Claude Code 必須綁定 Anthropic 的 API 金鑰。對於處理大型專案（Project）的開發者來說，Claude 需要頻繁掃描文件架構與上下文，這意味著 Token 的消耗速度極快。筆者曾試過在一個下午的除錯過程中，消耗了將近 20 美元的額度，成本驚人。

此外，數據私隱亦是專業開發者必須考慮的一環。將公司的核心算法或敏感代碼上傳到雲端，始終存在合規風險。而透過 Ollama 配合 CC Switch，我們能將整個運算過程保留在本地電腦，既解決了安全顧慮，更實現了真正的「零成本」使用。

核心組件介紹：Ollama 與 CC Switch

這次實作的核心主要由三個部分組成：

• Claude Code： Anthropic 官方推出的命令行開發助手。
• Ollama： 目前最受歡迎的本地模型運行框架，支援 Llama 3、DeepSeek 等頂尖開源模型。
• CC Switch： 這是一個關鍵的中間件（Middleware），它能將 Claude Code 的請求攔截並重新定向到本地的 Ollama 服務端，讓 Claude Code 誤以為自己正在與官方 API 對話。

實測步驟：從環境搭建到模型運行

第一步：安裝 Ollama 並部署強大模型

首先，我們需要準備一個強大的本地後盾。筆者推薦安裝最新版本的 Ollama。在終端機中，我選擇部署了 deepseek-v3 或是 llama3.1:70b（視乎你的硬體配置）。如果你使用的只是配備 16GB RAM 的 MacBook，建議選用 deepseek-coder 的小型化版本，反應速度會更流暢。

安裝指令非常簡單：ollama run deepseek-v3。確保你的本地伺服器已在 127.0.0.1:11434 正常運行。

第二步：安裝 Claude Code 官方工具

如果你尚未安裝官方工具，可以透過 NPM 進行全局安裝。筆者在此提醒，安裝過程中請務必確保 Node.js 版本在 18 以上，否則會出現兼容性報錯。這是我在實測中遇到的第一個小坑，升級 Node 版本後問題迎刃而解。

第三步：部署 CC Switch 進行橋接

這是最關鍵的一步。我們需要從 GitHub 下載 CC Switch 的工具包。它的運作原理是創建一個虛擬的代理環境。筆者在實作時發現，CC Switch 不僅支援 Windows 環境，在 macOS 的 Zsh 環境下表現同樣穩定。你只需要運行配置腳本，將目標轉向 localhost:11434，即可完成配置。

深度體驗：本地模型的表現如何？

在實際測試中，我讓本地運行的 Claude Code 嘗試重構一個複雜的 React 組件。令我驚訝的是，當使用 DeepSeek 模型作為後端時，代碼生成的邏輯嚴密性完全不遜色於原生的 Claude 3.5 Sonnet。

優點：

• 即時反應： 由於不需要經過跨境網絡傳輸，終端機的文字噴發幾乎沒有延遲。
• 完全免費： 不論你讓它寫多少行代碼，都不會收到銀行的扣費通知。
• 離線工作： 筆者曾在一次長途飛行的機艙內實測，在完全斷網的情況下，依然能順暢進行開發工作，這在以往是無法想像的。

技術細節與優化建議

在實踐過程中，筆者發現了一些值得優化的細節。首先是 Context Window（上下文窗口） 的設定。由於本地模型的內存限制，當專案文件過多時，模型可能會出現「記憶缺失」。我建議在 config.json 中手動調整緩存策略，優先加載當前目錄的代碼，而非全量掃描。

另外，硬體配置是影響體驗的上限。筆者目前使用的 M3 Max 晶片在運行 70B 模型時雖然精準，但風扇轉速會顯著提升。如果讀者的設備配置較一般，建議選用 8B 或 14B 的量化版本（Quantized version），以換取更佳的開發節奏。

總結：這不只是省錢，更是自由

這次的本地化嘗試，給了我極大的震撼。科技進步的意義，不應只是讓我們成為訂閱制服務的奴隸，而是賦予我們更多選擇的權利。透過 Claude Code 與 Ollama 的結合，我們證明了即便不依賴昂貴的雲端服務，依然可以擁有頂尖的 AI 開發體驗。

對於身處香港的開發者而言，這套方案更是一劑良藥。它讓我們徹底繞過了網絡環境的阻礙，回歸到純粹的開發樂趣中。如果你還在猶豫是否要繼續續費 API，不妨現在就嘗試搭建這套本地系統，感受那種「掌握主權」的快感。