AI猩导航 AI猩导航
工具导航 模型天梯 实用教程 替代方案 深度对比 AI 编程与开发 通用大模型与搜索 AI 图像与设计 AI 视频与音频
终端 AI 编程 约 5 分钟阅读 更新于: 2026-11-22

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 协议兼容。

Ollama Ollama

2. 加载大上下文编码模型

拉取 qwen3-coder 或 Qwen3.8-27B,并把上下文窗口显式调到至少 32K(推荐 64K)。

LM Studio LM Studio

3. 配环境变量并启动

设置 ANTHROPIC_BASE_URL 指向本地端口并清除官方 ANTHROPIC_API_KEY,直接启动。

Claude Code Claude Code

Ollama 与 LM Studio 原生直连完整命令(无需第三方代理)

整套切换最关键只有两个细节:ANTHROPIC_AUTH_TOKEN 随便填个非空占位符即可(比如 ollama),而原本如果系统里配过官方 ANTHROPIC_API_KEY,必须用 unset 清空,否则 CLI 还是会优先尝试找云端验证密钥。

Linux/macOS(含 Git Bash)切换 Claude Code 连本地 Ollama 与 LM Studio 示例
# --- 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 上下文窗口被瞬间撑爆。

本地流畅运行 Claude Code 的显存与上下文推荐配置
本机硬件条件务必调到的上下文推荐编码模型最实用玩法
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 或云端旗舰更省心。

教程中用到的工具

相关工具怎么选

常见问题

现在还要像以前那样自己装 LiteLLM 或各种 Router 中转代理吗?

只要更新到最新版 Ollama(v0.14.0+)或 LM Studio(v0.4.1+)就完全不需要了,两大引擎都已自带 /v1/messages 原生兼容端点,省掉一层折腾。

我是 Windows 电脑用 PowerShell,三条环境变量怎么写?

PowerShell 写法是:$env:ANTHROPIC_BASE_URL='http://localhost:11434'; $env:ANTHROPIC_AUTH_TOKEN='ollama'; Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue; claude --model qwen3-coder。

除了 Claude Code,开源的 OpenCode 能连同一个本地 Ollama 吗?

当然可以,而且 OpenCode 支持在同一个窗口会话里随时把免费本地模型热切换成云端高精度模型,灵活度更高。