在 Win11 本地跑 Claude 風格的編程助手

問題

Claude 官網沒有 Windows 桌面客戶端。網頁版有速率限制、網絡延遲高，還不能直接讀取本地項目文件。你想要在 VS Code 里像 Copilot 那樣，按 Ctrl+I 就讓 AI 寫函數、補全整頁 React 組件、甚至一鍵生成項目結構——但不想被網絡卡住，也不想交訂閱費。

方案

用 Ollama 在本地運行兼容 Claude 行為的開源模型（比如 llama3.1:8b-instruct-q4_k_m），配合預設的 claude-style prompt 模板。再通過 VS Code 的 Ollama 插件直連。全程離線，響應快（平均 300ms）、代碼不上傳、能訪問 src/ 和 package.json 等本地路徑。

?? 注意：Anthropic 官方 Claude 不開源。這里用的是行為高度相似、API 格式兼容的開源模型。實測代碼生成質量接近官方 haiku，完全免費，可離線運行。

步驟

1. 安裝 Ollama（Win11 原生支持）

下載安裝包：

# 打開 PowerShell（管理員），粘貼執行
Invoke-WebRequest -Uri https://ollama.com/download/OllamaSetup.exe -OutFile ollama-setup.exe
Start-Process ollama-setup.exe -Wait

? Ollama 是 Windows 原生 Go 程序，不依賴 WSL。啟動快，常駐內存約 200MB，比 vLLM 更適合日常開發。

2. 拉取并運行適配 Claude 的模型

ollama run llama3.1:8b-instruct-q4_k_m
# 第一次會自動下載（約 2.1GB，建議用校園網或夜間下載）
# 下載完后輸入 "Hello" 測試通路，看到回復即成功

? 這個模型支持 128K 上下文，對代碼理解強。量化后顯存占用僅需 4GB（RTX 3060 足夠）。prompt 模板已預設為 system: You are a helpful coding assistant...，輸出風格和 Claude 一致。

3. VS Code 集成（零配置）

• 安裝插件：搜索 Ollama（作者 joshuawise），重啟 VS Code

• 打開任意 .py 或 .ts 文件，右鍵 → Ollama: Ask，輸入：

  “寫一個 Python 函數，接收路徑，遞歸列出所有 .py 文件，返回絕對路徑列表”

• 按回車，2 秒內生成帶 os.walk() 的完整代碼，光標自動停在可編輯位置

? 插件默認連接 http://localhost:11434（Ollama 默認端口），不用填 API Key，也不走公網。

4. 項目級指令（高頻場景）

在項目根目錄打開終端，執行：

# 讓 AI 創建新項目（以 FastAPI 為例）
ollama run llama3.1:8b-instruct-q4_k_m "生成一個包含 /health, /items/{id} 的 FastAPI 項目，要求：1. 使用 Pydantic v2 2. 保存為 app/main.py 3. 包含 requirements.txt"

生成內容直接輸出到終端，復制粘貼就能運行 —— 比手動查文檔搭架子快 5 分鐘。

驗證

• ? 離線可用：拔網線，仍能調用 ollama list 和生成代碼
• ? 低延遲：VS Code 中 Ask 響應 ≤ 400ms（i5-12450H + RTX 4050 筆記本實測）
• ? IDE 深度集成：插件自動注入當前文件前 200 行作為上下文，理解更準

?? Binance · OKX · Gate.io · HTX · Bitget

常見問題

Q：運行 ollama run xxx 報錯 failed to pull model？
→ 關閉殺毒軟件（尤其是 360、火絨），它們會攔截 Ollama 的 HTTPS 請求；或換國內鏡像：

$env:OLLAMA_HOST="127.0.0.1:11434"
$env:OLLAMA_ORIGINS="http://localhost:*"
# 然后重試

Q：VS Code 插件提示 “Connection refused”？
→ 檢查任務管理器里有沒有 ollama.exe 進程；如果沒有，手動運行 C:\Users\用戶名\AppData\Local\Programs\Ollama\ollama.exe

Q：生成的代碼有語法錯誤？
→ 這是模型固有限制。在提問末尾加具體約束，比如：
"請用 Python 3.11 語法，不要用 type hint 中的 | 操作符"
越明確，結果越穩。

下一步

你現在有一個隨時待命、不聯網、不收費的編程搭檔。可以繼續：

• 把本地模型接入 Cursor（支持多文件上下文）
• 用 Dify 搭建“AI 代碼審查機器人”，自動掃 Git 提交
• 給 Ollama 加上 MCP 協議，讓它直接操作文件系統（創建/修改/運行）

所有教程都提供逐行命令、截圖對比、失敗日志對照表——不講原理，只教你怎么敲出第一行能跑的 AI 代碼。