Claude Code 免费接本地模型:Ollama 与 LM Studio 原生直连
不用花钱买翻译中转代理:Ollama 与 LM Studio 均已原生支持 Anthropic 接口,只需 3 行环境变量即可让 Claude Code 免费跑本地开源大模型。
很多人以为 Claude Code 终端只能绑 Anthropic 官方付费 Key,其实 Ollama(v0.14.0+)和 LM Studio(v0.4.1+)早就原生兼容了 Anthropic 的 /v1/messages 接口。只要设对环境变量、卸空官方 API Key 并将本地上下文窗口调大到 32K~64K,就能零 API 费用完全本地运行 Claude Code。
整体步骤
1. 升级本机运行环境
把 Ollama 升到 v0.14.0+(或 LM Studio 升至 v0.4.1+),获得原生 Anthropic 协议兼容。
2. 加载大上下文编码模型
拉取 qwen3-coder 或 Qwen3.8-27B,并把上下文窗口显式调到至少 32K(推荐 64K)。
3. 配环境变量并启动
设置 ANTHROPIC_BASE_URL 指向本地端口并清除官方 ANTHROPIC_API_KEY,直接启动。
Ollama 与 LM Studio 原生直连完整命令(无需第三方代理)
整套切换最关键只有两个细节:ANTHROPIC_AUTH_TOKEN 随便填个非空占位符即可(比如 ollama),而原本如果系统里配过官方 ANTHROPIC_API_KEY,必须用 unset 清空,否则 CLI 还是会优先尝试找云端验证密钥。
# --- Option 1: Ollama (v0.14.0+) ---
ollama pull qwen3-coder
export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
unset ANTHROPIC_API_KEY
claude --model qwen3-coder
# Tip: Ollama also includes shortcut: ollama launch claude
# --- Option 2: LM Studio (v0.4.1+, set 64K context!) ---
lms load qwen/qwen3-coder-30b --context-length 65536
lms server start --port 1234
export ANTHROPIC_BASE_URL=http://localhost:1234
export ANTHROPIC_AUTH_TOKEN=lmstudio
unset ANTHROPIC_API_KEY
claude --model qwen/qwen3-coder-30b 跑本地 Claude Code 最关键调优:上下文窗口绝对不能只开默认 4K
由于 Claude Code 自带完整的工具定义、工程目录结构和历史 Diff 上下文,很多本地用户跑起来直接报错或乱改,核心原因往往不是模型智商不够,而是本地引擎默认只分配了 4K 或 8K 上下文窗口被瞬间撑爆。
| 本机硬件条件 | 务必调到的上下文 | 推荐编码模型 | 最实用玩法 |
|---|---|---|---|
| 16GB Mac / 12GB 显卡 | 32K(可用底线) | Gemma 4 12B / Qwen3.8 轻量量化 | 修单个涉密模块、写测试或离线解释项目 |
| 24GB 显卡 / 32GB~64GB Mac | 64K(最佳甜点区) | Qwen3.8-27B / qwen3-coder-30b | 个人主力私有化编码、完整工具调用闭环 |
| 本地 + OpenCode 混跑切换 | 128K~1M 动态切换 | 前端侦察用本机 Ollama,硬骨头切云端 Claude/GLM-5.3 | 日常零费用,疑难重构照样不妥协 |
使用前避坑提醒
- 如果终端里原本设过官方 ANTHROPIC_API_KEY 必须先 unset 清空(PowerShell 下用 Remove-Item Env:ANTHROPIC_API_KEY),否则容易引发鉴权冲突。
- LM Studio 里加载模型一定要把 Context Length 手动拉到 32768 或 65536 以上,默认 4096 上下文根本装不下 Claude Code 的工具描述。
- 7B~8B 太小的模型在复杂多文件编辑时极易反复重试死循环——设备显存小于 16GB 时建议专攻单文件修改,复杂跨仓重构还是搭配 OpenCode 或云端旗舰更省心。