1. 本地 Claude Code 接 LM Studio 跑 Gemma 4 12B为什么一调 API 就炸你如果在本地把 Claude Code 指向 LM Studio加载gemma-4-12b-it-ud这类 Gemma 4 12B 模型很可能遇到一个很迷惑的现象LM Studio 的图形聊天窗口里对话完全正常模型回答流畅但只要换成 API 调用立刻返回一段 Jinja 模板渲染错误核心信息是Cannot call something that is not a function: got UndefinedValue。这个报错不是模型权重坏了也不是你的显卡或显存不够而是 LM Studio 内置的 Prompt Template 里引用了一个没有定义的宏。Claude Code 本身是一个面向终端的编码代理工具它通过 OpenAI 兼容或 Anthropic 兼容的接口把对话、工具调用请求发给后端。当后端是 LM Studio 时LM Studio 会用模型自带的 Jinja 模板把请求渲染成模型能读的提示词。问题就出在这一步Gemma 4 的模板里到处调用format_type_argument这个宏但模板顶部压根没定义它。图形界面走的是另一套渲染路径所以不触发API 路径会严格走 Jinja 模板于是直接抛UndefinedValue。这篇记录面向三类人一是刚在本地跑 Claude Code 想省点 API 费用的开发者二是用 LM Studio 加载 Gemma 4 12B 做工具调用实验的人三是被这个报错卡住、搜了半天没找到可复制配置的人。我会把链路、根因、可复制的模板补丁、config.toml和settings.json骨架、curl 验证、以及几个容易踩的坑全部写清楚你照着做基本能复现并修好。需要先说明的是本文聚焦本地 LM Studio 的模板修复。如果你希望 Claude Code 在长编码任务、Agent 循环里更稳定也可以把部分请求分流到托管服务后面 CTA 部分会给到对应入口但主线仍是本地修复。2. 先理清链路Claude Code、cc switch、LM Studio 各管什么2.1 请求到底经过了哪几层典型链路是这样的Claude Code 发出请求 → cc switch 做协议转换和端点转发 → LM Studio 的 Local Server 接收 → LM Studio 用 Gemma 4 的 Jinja 模板渲染提示词 → 模型推理 → 原路返回。任何一层配置错位都会报错但这次的UndefinedValue明确指向第四层也就是模板渲染。cc switch 的作用是把 Claude Code 习惯的 Anthropic 风格请求转成 LM Studio 能吃的 OpenAI 兼容格式。所以你在 cc switch 里必须把 base URL 指向http://localhost:1234/v1而不是 Anthropic 原生端点。这一点后面排障会再强调。2.2 为什么 GUI 正常、API 报错LM Studio 的图形聊天和 API 服务在模板渲染上并不完全共用同一条代码路径。图形界面可能对缺失宏做了容错或者用了简化模板而 API 路径会完整执行模型目录里的 Jinja 模板。当请求里带tools参数时模板会走到format_parameters和format_type_argument这些分支缺失的宏就被触发了。所以你会看到纯聊天可能偶尔能过一旦 Claude Code 带上工具定义就必炸。2.3 环境版本要记录清楚出问题的组合是 LM Studio v0.4.16 gemma-4-12b-it-ud。不同小版本的内置模板可能不同所以修复前先确认你的 LM Studio 版本和模型标识。可以在 Local Server 页面看到已加载模型名也可以在终端用curl http://localhost:1234/v1/models列出当前可用模型确认名字拼写和请求里一致。3. TaoToken 前置本地修复之外的托管分流准备本地跑 Gemma 4 12B 适合离线、隐私敏感、零边际成本的场景但它对显存、上下文长度、工具调用稳定性都有要求。如果你在修好本地模板后还想让 Claude Code 在复杂编码任务里更省心可以准备一个托管入口做分流。TaoToken 提供 OpenAI 兼容与 Anthropic 兼容的接入方式官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。实际操作上你可以先在控制台创建密钥入口是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 密钥管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你只是想先验证模型对话效果可以用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期跑编码和 Agent 的话Coding Plan 入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite Claude Code 相关说明在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。这部分只是给你一个备选路径本地模板修复仍然是本篇主线。下面进入可复制配置。4. 可复制配置模板补丁、config.toml 与 settings.json4.1 第一步进入模型设置并切换为 Override在 LM Studio 左侧进入 Local Server 页面找到 Loaded Models 列表里的gemma-4-12b-it-ud点右侧齿轮图标进入 Model Settings。找到 Prompt Template 区域把下拉从 Default 改成 Override。只有切到 Override你手动改的模板才会生效。4.2 第二步在模板最顶部插入缺失的宏关键动作只有一件事在模板文本框的最顶部也就是第一个format_parameters宏之前插入下面三行。注意减号位置{%-和-%}都不能写错。{%- macro format_type_argument(type_arg) -%} {{- type_arg if type_arg is string else format_argument(type_arg) -}} {%- endmacro -%}插入后模板顶部结构应该长这样原有内容一行都不要动{%- macro format_type_argument(type_arg) -%} {{- type_arg if type_arg is string else format_argument(type_arg) -}} {%- endmacro -%} {%- macro format_parameters(properties, required, filter_keysfalse) -%} ...原有内容保持不变这里有个我踩过的坑不要从网上复制整份模板全量替换。不同来源的模板版本可能括号或语句闭合不一致替换后会报Parser Error: CloseStatement ! CloseExpression反而更难查。只补这三行是最稳的。4.3 第三步保存并重新加载模型点 Save回到 Local Server先 Eject 模型再重新 Load Model。如果界面有刷新按钮也可以点刷新让模板重新编译。很多人改完没重新加载以为没生效其实只是旧模板还在内存里。4.4 第四步cc switch 的 config.toml 骨架cc switch 的配置因版本而异但核心是 base URL 指向 LM Studio 的 OpenAI 兼容端点。下面是一个可参考的config.toml骨架字段名请按你本地版本微调# cc switch 配置骨架指向本地 LM Studio [provider.local_lmstudio] type openai base_url http://localhost:1234/v1 api_key lm-studio model gemma-4-12b-it-ud [claude_code] provider local_lmstudio # 工具调用相关请求会走 OpenAI 兼容格式注意api_key对 LM Studio 来说通常随便填它不校验但字段不能缺。base_url末尾的/v1不能少少了会 404。4.5 第五步Claude Code 的 settings.json 骨架Claude Code 侧一般通过环境变量或settings.json指定后端。下面是一个可参考的settings.json骨架{ env: { ANTHROPIC_BASE_URL: http://localhost:1234/v1, ANTHROPIC_API_KEY: lm-studio, ANTHROPIC_MODEL: gemma-4-12b-it-ud } }如果你用的是 cc switch 做转换那么 Claude Code 指向 cc switch 的本地端口cc switch 再指向 LM Studio。两种拓扑都行关键是别让 Claude Code 直接去请求 Anthropic 原生格式的端点LM Studio 不认。5. 验证请求用 curl 确认模板修复成功5.1 先测最简对话改完模板、重新加载模型后先用最简请求确认模板不再抛UndefinedValuecurl http://localhost:1234/v1/chat/completions \ -H Content-Type: application/json \ -d { model: gemma-4-12b-it-ud, messages: [{role: user, content: Hello}] }如果返回的是正常文本内容说明基础模板渲染已经通过。如果还是UndefinedValue回到第 4.2 节检查三行宏是否真的在模板最顶部、减号是否正确、是否点了 Save 并重新加载。5.2 再测带 tools 的请求Claude Code 真正会触发问题的是带工具定义的请求。用一个最小 tools 请求验证curl http://localhost:1234/v1/chat/completions \ -H Content-Type: application/json \ -d { model: gemma-4-12b-it-ud, messages: [{role: user, content: What is the weather in Beijing?}], tools: [ { type: function, function: { name: get_weather, description: Get weather by city, parameters: { type: object, properties: { city: {type: string} }, required: [city] } } } ] }这一步能过基本说明format_type_argument缺失导致的问题已经解决。返回里可能会带tool_calls字段也可能模型选择直接回答都算正常只要不是模板报错。5.3 最后跑 Claude Code 实测确认 curl 两层都通过后再启动 Claude Code让它执行一个简单任务比如读取当前目录文件并总结。观察终端是否还有模板错误。如果 Claude Code 报连接错误而不是模板错误那问题就转移到 cc switch 或 base URL 配置上了按下一节排查。6. 本篇常见错排查从模板到端点的逐层定位6.1 报错依旧是 UndefinedValue先确认三行宏是否在模板最顶部。Jinja 的宏定义必须在被调用之前如果插到了format_parameters后面调用时仍然找不到。再确认减号{%-是左减号-%}是右减号写反或漏写会导致空白控制异常虽然不一定报同一个错但会影响渲染。最后确认是否 Eject 后重新 Load旧模板缓存很常见。6.2 报 Parser Error: CloseStatement ! CloseExpression这通常是你全量替换了模板或者粘贴时引入了不可见字符。解决方式是恢复默认模板只手动插入那三行。不要用富文本编辑器粘贴用纯文本方式输入。如果已经乱了把 Prompt Template 切回 Default保存再切 Override 重新补。6.3 cc switch 报连接失败或 404检查base_url是否为http://localhost:1234/v1。LM Studio 默认端口是 1234但如果你改过端口要同步改。404 多半是少了/v1或者请求打到了 Anthropic 原生路径。连接失败则确认 LM Studio 的 Local Server 已经启动并且模型处于 Loaded 状态。6.4 模型名不匹配请求里的model字段必须和 LM Studio 里加载的模型标识一致。用curl http://localhost:1234/v1/models查看准确名字。有时候你下载的是gemma-4-12b-it-ud但加载后显示的名字带了量化后缀或路径复制准确值即可。6.5 不想手动改模板的替代方案如果你不想动模板可以从lmstudio-community重新下载同名模型社区版通常已经修了这个宏缺失问题。下载后重新加载再用 curl 验证。这是最省事的路径缺点是可能要重新占磁盘和下载时间。6.6 工具调用仍然不稳定模板修好后如果 Claude Code 的工具调用时好时坏那多半是模型本身对工具调用的支持程度问题而不是模板报错。Gemma 4 12B 在本地量化后工具调用格式遵循度会下降。这时候可以考虑把复杂 Agent 任务分流到托管服务本地只做轻量对话和草稿。7. 语义一致 CTA修完本地之后怎么继续本地模板修复解决的是启动失败和 API 渲染报错属于接入层问题。如果你在排障过程中还想确认某个模型的实际对话表现可以先用模型对话页快速试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你准备把 Claude Code 接到托管端点先去控制台建密钥https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 密钥在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 管理接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 和 Claude Code 专页 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。长期跑编码和 Agent 循环可以用 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。API 基址统一是 https://taotoken.net/api 官网入口 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实用习惯每次改完 LM Studio 模板先跑第 5.1 节的最简 curl再跑 5.2 节的 tools curl两层都过再启动 Claude Code。这样能把模板问题、端点问题、模型问题分开定位省掉大量来回试错的时间。