每篇“用本地模型代替 Claude Code”的指南开篇都如出一辙:一堆 SWE‑bench 分数,一声得意的 “我们只离前沿相差五分”,以及一张 GPU 采购清单。我读过十几篇,也跑过大部分方案。它们没错,只是在测量容易得到的指标,而不是决定你能否真的关掉 Claude Code 标签页的因素。
下面是没人会放在标题里的版本——在让 Claude Code 和 Codex 指向本地模型进行真实工作之后:
本地大模型能写出正确的函数已经是个已解决的问题。而本地大模型能够可靠地充当 智能体 —— 在多文件编辑过程中连续十次输出干净的工具调用,且不偏离 schema —— 这一点还没做到。而第二点才是整个工作的核心。
那么我们来认真做一下。我们将梳理在 2026 年底真正重要的模型家族,每个模型实际上适用于什么场景(实际上适用于),硬件现实,部署过程(现在只需 60 秒),没人会截图的失效模式,以及一个成本模型,让你知道这是否能省下一分钱。配上图表,因为你不得不眯着眼看的一堆数字表格恰恰是问题所在。
首先:为什么这突然就有效了
2026 年发生了两个变化,且都不是“模型在 Twitter 上声音更大了”。
1. Mixture-of-Experts 突破了硬件瓶颈。 一个密集的 70B 模型在每个 token 上都会激活全部 70B 参数。而 MoE 模型虽然总参数量巨大,但每个 token 只激活一小部分——以 Qwen 的 35B-A3B 为例,激活约 3B 参数。显存占用取决于你加载的 文件大小;运行速度取决于那个微小的活跃切片。于是,以前需要服务器才能跑的模型,现在在游戏显卡上就能运行,进一步量化后甚至能在笔记本上跑。
2. 智能体学会了使用本地语言。 这是 2025 年的帖子所遗漏的部分。在 2026 年 1 月,Ollama 原生支持了 Anthropic Messages API,LM Studio 和 llama.cpp 随后跟进。这就是突破点:Claude Code 不再需要代理垫片来与 localhost 通信。只需将一个环境变量指向它,它就能工作。管线不再是难点——这意味着对话终于 必须 超越 “它能写代码吗” 这一问题。
大家引用的数字 —— 以及它为何会误导你
SWE‑bench Verified 是每条标题里的统计数字,而公布的 2026 年数据确实紧贴前沿。
看完这张图表,故事似乎已经结束:单张 24GB 显卡上的模型得分约为 77,与云端前沿仅相差一个四舍五入的误差。但这里有个关键点,也是全文的核心:
SWE-bench 衡量的是“给定一个 bug,产出一个正确的补丁。”这是一个 writing 任务。 它几乎没有提到模型在 driving your editor 时实际上会出问题的四个方面。
-
Tool-call validity — 它能否可靠地发出解析器能够解析的格式正确的
edit_file/run_command调用?通常情况下不能? - Long-horizon consistency — 调用 #11 是否还记得调用 #2 的计划?
- Context under load — 在真实仓库的 40K tokens 下质量是否能保持,还是在宣称的窗口之前就崩溃?
- Instruction-following — 当你说“不要碰测试”时,它是否真的不碰测试?
这四项都不在排行榜上。正是这四项导致你的本地配置 感觉 与演示不同。
⚠️ 将本文中的每个数字都视为厂商报告。 不同的指南会对同一模型给出截然不同的分数,因为他们悄悄把 SWE-bench Verified 换成了 Pro 或 Terminal-Bench,却从不说明。在仅凭一个百分比就购买 GPU 之前,请先在官方 SWE-bench 排行榜上进行验证。
值得了解的 7 个家族(以及每个家族的实际用途)
应考虑 家族,而非单个检查点 — — 每个家族都有多种规格,合适的选择是同时匹配你的显卡和工作需求的那个。
1. Qwen 3.x — 本地编码的骨干
如果你只跑一个家族,那就是这个。Qwen 在编码 and 工具调用两方面都是开放权重的领导者,而这种组合正是关键所在。
- Qwen 3.6 27B (dense) — 默认的自托管编码器。~77% SWE-bench Verified,~22GB 量化版,可放入单张 24GB GPU 或 M 系列 Mac。可靠的工具调用者。
- Qwen 3.5 35B-A3B (MoE) — 35B 总参数,~3B 活跃。运行惊人地轻巧(Q4 精度下仅需 8GB VRAM),因为只有活跃的切片会产生计算开销。这是“笔记本电脑上的前沿”代表作。
- Qwen3-Coder (30B-A3B / 480B-A35B / Next-80B-A3B) — 代码专用系列。30B 是很好的日常驱动;如果你有 64GB+ 统一内存或多 GPU,480B 是目前最强的开源代码模型。
最适用于: 你的通用编码 Agent,工具使用工作流,以及任何想要 一个 模型来完成 80% 工作的人。弱点: 没有明显短板——它是安全的默认选择。
2. GLM-4.x — 长会话 Agent 的预算友好选择
GLM 在其规模之上表现出色,在 长、重工具 Agent 运行 中,Flash 变体是真正可用的最轻量选项。
- GLM-4.7-Flash — ~59% SWE-bench,运行在 5–8GB 笔记本电脑 上。这是“我只有集成显卡左右的 GPU”选项,决不是玩具。
- GLM-4.6 / 4.x (MIT license) — 推荐用于需要长时间、多步骤 Agent 会话的场景,在这些场景中,多次调用的一致性比单次击中的原始得分更重要。
最适用于: 笔记本级硬件,长 Agentic 会话,宽松许可证的公司。弱点: 在硬核单次编码上的上限低于 Qwen 27B。
3. DeepSeek V3.2 / V4-Pro — 最高开放上限
DeepSeek 发布了目前开源的最佳成绩 — V4-Pro 达到 ~80.6% SWE-bench Verified — 但只有在你的办公桌上放置一台服务器(80GB+)时才能算是“本地”运行。
最适用于: 在你拥有服务器级硬件或为团队准备自托管盒子时,处理纯粹、艰巨的编码任务。弱点: 不是消费级 GPU 模型;这是升级层级,而非日常驱动。
4. Devstral Small 2 — 宽松许可证的工作马
~68% SWE-bench Verified,Apache-2.0 许可证,适用于 12–16GB 显存。这是“我需要一个干净的许可证且能在中等显卡上运行”选项,也是其规模下可靠的 Agentic 编码器。
最适用于: 商业使用且需要许可证确定性,中等 GPU,Agentic 子任务。弱点: 多文件推理的上限低于 27B 级别。
5. Kimi K2.x — 长视野前沿(如果你有机架)
Kimi 面向长时程的智能体工作,在更具挑战性的 Pro 基准测试中表现良好,但需要大量量化或服务器硬件才能在本地运行。
最适用于: 在性能较强的硬件上进行长时间自主运行。弱点: 不是单消费级 GPU 的现实选择;基准测试数据基于 Pro,因此不要直接与上面的 Verified 数据进行对比。
6. GPT-OSS (20B / 120B) — OpenAI 的开放权重,Codex-native
OpenAI 的开放权重系列通过 --oss 标志自然地集成到 Codex CLI 中。20B 版本可在消费级硬件上运行;120B 版本属于服务器级别。
最适用于: 已经在 Codex 上统一标准化的团队,他们希望拥有零工具链摩擦的本地后备方案。弱点: Qwen/GLM 在开放工具调用可靠性方面通常略胜一筹。
7. Gemma 4 — 轻量级通用模型
Gemma 4(12B / 27B)是面向低硬件要求的通用模型——在你需要一个全能型模型而非代码专家时,16GB 机器上表现出色。
最适用于: 笔记本电脑、混合编码+写作场景、低显存设备。弱点: 它是通用模型而非代码专家——在困难的 SWE 任务上,它会落后于专门针对代码调优的模型。
(荣誉提及:**MiniMax M2.x, 采用 agent-first 训练且定价激进——如果 throughput-per-dollar 是你的限制,则值得关注)
效率拐点:更多硬件 ≠ 更好
以下是实际应指导你 GPU 决策的图表——性能与达到该性能所需的 VRAM 成本对比。
曲线在 ~24GB 前陡然上升,随后 变平 — — 480B 编码模型即便在 Verified 基准上 低于 27B,却消耗了 3 倍内存。经验表明:在 单张 24GB 消费级 GPU 上运行 Qwen 3.6 27B 是自托管的最佳点。超过这一点后收益递减,除非你特别需要服务器级别的上限。
排行榜掩盖的墙:工具调用
这是让我重新考虑如何挑选本地模型的发现。工具调用是一项与编写代码分别训练的技能。模型能够生成漂亮函数,但仍可能失去智能体所需的关键 — — 在每次尝试首次就发出有效工具调用。
证据所指向的结论:
- 在 ~4B 参数以下,可靠性会骤降。 无论哪种智能体包装,7B 以下模型都会输出格式错误的工具调用。 若模型无法正确格式化调用,harness 也无法挽救。
- 原生工具使用训练胜过事后加上的语法约束。 使用工具模板训练的模型表现正常; 带有约束解码并被额外添加的模型会漂移。
- 模型比 harness 更重要。 将 Claude Code 切换为 OpenCode 再到 Codex 也无法修复输出乱码 JSON 的模型。
- 多步链是失效点。 单次工具调用没问题。 连续五次,每次依赖前一次的结果,较小的本地模型就会开始出现 幻觉 调用。 它们可能发明一个不存在的函数,或使用漂移的参数重新调用已有函数。 于是智能体陷入重试循环。
实际的切割点:对于智能体工作,需要选取 具备原生工具训练的 14B–32B 模型系列。到了 2026 年底,这基本上意味着 Qwen,而 GLM-4.x 和 Devstral Small 2 是可信的替代选择。低于 ~7B 的只不过是扮演智能体的聊天模型。
安装确实只要 60 秒
如今智能体已经能够使用本地模型,这并不令人意外 — — 这正是目的。
Claude Code → 本地模型(通过 Ollama):
# 1. pull a capable coder
ollama pull qwen3-coder:30b
# 2. point Claude Code at localhost + a throwaway token
export ANTHROPIC_BASE_URL="http://localhost:11434"
export ANTHROPIC_AUTH_TOKEN="local-dummy"
# 3. run it
claude
Codex CLI → 本地模型: Codex 可以与任何 OpenAI 兼容的端点通信。使用 Ollama 时,--oss 标志将其指向本地服务器(:11434);LM Studio 在 :1234/v1 提供服务。在 config.toml 中固定提供者/模型。
工具链选择: Ollama 是终端优先的选项(它甚至为 Claude Code / Codex / OpenCode 提供一键启动器);LM Studio 是 GUI。两者皆可 — — 请记住,模型而非工具链决定了你的工具调用可靠性。
以下两个陷阱各让我花了一晚上:
- 显式设置上下文窗口 — — 至少 32K,理想情况下 64K+。默认值通常很小,编码 Agent 会瞬间饥饿。但质量在广告宣传的上限之前就已经下降,KV 缓存会占用你本来用于权重的显存。两者都要预算。
-
返回云端时:
unset ANTHROPIC_BASE_URL(或从settings.json中删除)。直到你忘记这一点,才会好奇为什么 “Claude” 变笨了。
硬件层级指南
| 你的硬件 | 选择 | 实际情况 |
|---|---|---|
| 8GB 笔记本 / 小型 GPU | GLM-4.7-Flash, Gemma 4 12B | 可用于单文件帮助;在 Agent 工作中期望重试 |
| 12–16GB GPU | Devstral Small 2, Qwen3-Coder 14B-class | 可靠的日常编码器;干净的 Apache-2.0 选项 |
| 24GB GPU(甜蜜点) | Qwen 3.6 27B | 值得购买的选择;可靠的工具调用者,~77% SWE-bench |
| 64GB+ 统一 / 多 GPU | Qwen3-Coder-480B, GPT-OSS 120B | 专家上限;收益递减 |
| 服务器 80GB+ | DeepSeek V4-Pro, Kimi K2.x | 团队盒子 / 升级层级,而非桌面机器 |
它实际上在哪里出问题(诚实部分)
在真实工作中连续运行一周,你会发现规律很明确:一个好的本地编码器大约能提供云端 Claude 70% 的能力来处理常规单文件任务,而随着工作变得更具 Agent 性,差距会迅速扩大。 按照发生频率从高到低,失效模式如下:
- Schema drift → 重试循环。 模型会输出一个 略微 畸形的编辑,工具链会拒绝它,重试时它会以不同方式漂移。在困难的步骤上,这会消耗掉十几次往返。
这些并不会让本地变得无用。它让本地成为一种 不同的工具,而不仅是一个更便宜的复制品。
它真的能省钱吗?
这是人们尝试的真正原因,所以让我们来算算账,而不是仅仅看“免费”这一说。本地并不是免费的 — — 它是 预付费的。你用固定硬件、电力以及照看重试所花的时间来换取按量计费的 API 账单。
- 能够轻松运行 Qwen 3.6 27B 的二手 24GB GPU:几百美元,一次性支出。
- 持续负载下的电费:虽然真实但很小 — — 个人每月仅需个位数美元。
- 相对而言:一个重度 Claude Code 用户每月可能花费几百美元,而运行 Agent 群的团队则会开出令人咋舌的账单(每月“4,660美元”的截图如今已成为一种常见景象)。
坦率结论:对于只是随手写代码的个人来说,仅仅谨慎使用云服务往往比本地部署更能回本 — — 硬件和调试的成本超过了你能节省的金额。它在 高频、重复或受隐私限制的工作负载 上会显著转折 — — 尤其是 Agent 群,你可以将便宜的 80% 调用路由到本地模型,仅在需要前沿模型的 20% 上消耗前沿 token。这种 路由 — — 而不是简单地“替换 Claude Code” — — 才是 2026 年的实际胜利。
进行决策的框架
别再纠结“哪个模型最好”了,要问“这是哪项 工作?”
在以下情况下选择本地:
- 私有或离线 — 代码无法离开机器。
- 高吞吐、低成本每任务 — 一千个小的分类/摘要/样板子调用,在群集中。
- 窄且单文件 — 一个函数、一个测试、一个正则表达式、一次迁移。
- 省积分 — 将简单的 80% 放在本地运行,将困难的 20% 上升到云端。
保留云端 Claude/Codex 用于:
- 多文件、长周期更改——在多步骤中保持一致性 是 价值所在。
- 大上下文工作——你需要完整的窗口才能真正发挥作用。
- "一次就对,快速"——任何重试循环成本超过 token 的情况。
我得到的结论是:本地正在成为默认,前沿模型是升级路径。 这与当今大多数团队的做法相反——也是钱所在的地方。
真正的答案
本地大模型能否取代 Claude Code? 作为你在困难的多步骤、大上下文工作中的智能体——目前还不行,限制它的不是 SWE-bench 分数,而是长时间会话中的工具调用可靠性。 作为处理不需要前沿模型的 80% 任务的廉价、私有、随时可用的工作马——绝对可以,今天,单张 24GB GPU 就能做到,而且每月都在改进。
错误在于把它当成非黑即白的选择。获得真正价值的人并不是在“替代”任何东西。他们运行两种模型,知道哪项工作交给哪种模型。
如果这篇文章对你有帮助,请关注我——我撰写关于 AI 智能体、本地模型以及围绕它们的不那么光鲜的工程,并且我在模型发布时测试更多这样的配置。
轮到你了: 对于你来说,实际的分界线是什么——也就是你会转向云端、不愿相信本地模型的具体任务?我正在收集真实的断点,而不是基准测试中的断点。👇
来源及自行验证
本文中的数字是由供应商报告且每月变动 — 不要仅凭博客上的百分比就购买硬件。请在主要来源处核实:
- SWE-bench 排行榜 — 官方编码基准测试;在比较前请确认 Verified 与 Pro 的区别。
- 伯克利函数调用排行榜 — 实际衡量工具调用的指标,正是本文一直强调最重要的那个。
成本和工具调用分级的图表仅供参考,主要用来展示权衡的大致趋势——把你的 API 账单和 GPU 价格代进去,才能得到真正适用于你的数字。



