最新版 Claude Desktop LM Studio 直连配置指南LM Studio 0.4.19前置阅读LM Studio API Token 获取与权限配置完全指南 —— 本文所需的 API Key 获取方法旧版 Claude Desktop 配置指南 —— 如果你的 Claude Desktop 版本低于 1.18286.0Claude Desktop 启用开发者模式 配置第三方模型 详细步骤一、版本要求组件版本说明Claude Desktop1.18286.0本文测试版本1.18286.0 (259c3f)LM Studio0.4.19关键分水岭版本原生支持 Anthropic-compatible 端点操作系统Windows 10/11本文环境macOS/Linux 原理相同硬件参考RTX 3090 24G测试模型约 18G加载后显存占用较高重要变化Claude Desktop 最新版本1.18286.0已移除右上角便捷模型切换功能这可能是 Anthropic 的排外策略调整。现在模型选择固定在对话底部切换需在 LM Studio 重新加载模型以实现切换。二、LM Studio 端准备2.1 预加载模型强烈建议LM Studio 支持 JIT即时模型加载但强烈建议预先加载首次加载耗时数秒到数十秒取决于模型大小和硬盘速度显存占用以glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max为例约 18G 模型在 RTX 3090 24G 上加载后剩余显存紧张超时风险如果 Claude Desktop 请求时模型未加载可能响应超时或报错操作步骤打开 LM Studio → 左侧选择模型 → 点击Load确认模型状态为READY绿色标签保持 LM Studio 运行不需要关闭注意如果未预加载Claude Desktop 可能触发 LM Studio 自动加载但等待时间过长会导致请求失败。2.2 开启 Local Server 并切换 Anthropic-compatible 端点操作路径左侧边栏Developer 扳手图标→Local Server确认Status: Running为绿色点击Server Settings⚙️ 齿轮图标底部支持的端点区域 → 切换到Anthropic-compatible确认显示POST /v1/messages截图[Local Server 入口和 Status 开关][Server Settings 弹窗][Anthropic-compatible 端点切换]关键请切换到此模式查看用法停留在 OpenAI-compatible 用法示例会导致路径拼接错误如/v1/messages/v1/models。2.3 获取 API Token请参考独立文章LM Studio API Token 获取与权限配置完全指南简要步骤Server Settings →Manage Tokens→Create new token命名如claude-desktop→ 勾选权限 →Create立即复制 Token关闭后无法再次查看三、Claude Desktop 端配置Claude Desktop 启用开发者模式 配置第三方模型 详细步骤3.1 开启 Developer Mode顶部菜单Help → Troubleshooting → Enable Developer Mode应用自动重启重启后顶部出现Developer菜单3.2 配置 Gateway路径Developer → Configure third-party inferenceConnection 配置配置项填写内容注意事项Gateway base URLhttp://localhost:1234/⚠️ 不要加/v1Gateway API key你的 LM Studio Token参考 Token 获取文章Gateway auth schemebearer保持默认Models 配置向下滚动配置项填写内容说明Model IDclaude-opus-4⚠️ 必须伪装不能填真实模型名Display nameclaude-opus-4建议与 Model ID 一致Offer 1M-context variant关闭根据实际模型能力Tier aliasopus或留空截图3.3 应用并重启点击Apply Changes → Relaunch now四、关键陷阱必看4.1 Test connection 首次配置红色是正常的Claude Desktop 的 Test connection 测试的是GET /v1/models模型列表但 LM Studio 的 Anthropic-compatible 模式只实现了POST /v1/messages没有模型列表接口。❌ Test connection 若暂时不通则是红色有时可能是模型延迟加载导致若连通则是绿色 ✅✅不影响实际对话直接 Apply 即可。首次配置时只要重启后不出现报错提示即可表示配置参数基本正常。4.2 模型名必须伪装Claude Desktop 硬性校验模型名格式必须是claude-*不能用的名字可以用的名字glm-4.7-flash-uncensored-...❌claude-opus-4✅openai/gpt-oss-20b❌claude-sonnet-4✅gemma-3-27b-it❌claude-haiku-4✅原理新版 Claude Desktop 会忽略 LM Studio 传来的模型名直接使用当前加载成功的模型推理。伪装名只是骗过 Claude Desktop 的校验。4.3 localhost vs 127.0.0.1实战经验http://127.0.0.1:1234→ 某些网络环境下失败可能与 Windows 路由表或虚拟网卡有关http://localhost:1234→推荐更稳定直接4.4 Base URL 后缀陷阱我填的实际请求结果http://localhost:1234/有可能也会有/干扰✅http://localhost:1234/v1/v1/v1/messages❌ 404http://localhost:1234/v1/messages/v1/messages/v1/messages❌ 404http://localhost:1234/v1/messages✅五、验证连接重启后新建对话底部模型选择器显示claude-opus-4或你的 Display name发送测试消息LM Studio Developer Logs 应出现plain[INFO] [glm-4.7-flash-...] Finished streaming Anthropic response截图[Claude Desktop 成功对话][LM Studio 日志]六、实际体验与性能数据6.1 测试环境项目配置GPURTX 3090 24G模型glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max模型大小约 18GQ4_K_S 量化上下文长度202752 tokens约 20万 token上下文长度获取位置LM Studio 右侧 Model Information →Context and Offload→上下文长度6.2 性能表现场景体验普通 Chat 模式响应正常速度可接受Cowork 模式较慢因模型体积大 显存紧张复杂任务处理有明显延迟显存占用加载后剩余显存有限建议关闭其他 GPU 应用建议如果主要用于 Cowork 模式多步骤、长上下文考虑使用更小的模型如 7B-9B以获得更好响应速度。6.3 工具调用与文件读取测试测试场景Cowork 模式下读取本地文件夹中的文档和 PDF功能结果本地文件读取✅正常可正确读取并返回内容PDF 解析✅正常能提取并理解 PDF 内容多文件处理✅正常支持批量文档分析结论LM Studio 的 Anthropic-compatible 端点完整支持 Claude Desktop 的 Cowork 模式功能包括文件系统访问和文档处理。6.4 模型切换限制Claude Desktop 1.18286.0 已移除便捷模型切换旧版本右上角下拉菜单可直接切换模型新版本模型选择固定在对话底部且 Gateway 模式下切换需重新在 LM Studio 切换模型变通方案在 LM Studio 中 Eject 旧模型 → Load 新模型Claude Desktop 中保持claude-opus-4伪装名不变七、错误排查速查表报错原因解决Your provider setup needs a fix缺少模型配置 / 模型名不对Models 区域添加claude-opus-4Configured model not available模型名不是 Anthropic 格式改成claude-opus-4Cant reach localhost:1234LM Studio 未启动 / 端口错误确认 Server RunningTest connection 红色正常无模型列表接口忽略直接 Apply对话超时 / 无响应模型未预加载 / 显存不足预加载模型关闭其他 GPU 应用Unexpected endpoint (LM Studio 日志)Base URL 带/v1后缀改为http://localhost:1234八、新旧方案对比旧版配置Claude Desktop 启用开发者模式 配置第三方模型 详细步骤场景Claude Desktop 1.182Claude Desktop 旧版LM Studio Base url❌ 不友好✅ 原生支持配置复杂度较复杂简单模型名要求伪装claude-*直接获取 LM模型 快速切换工具调用支持✅ 完整支持✅ 完整支持推荐方案直接连接旧文章九、进阶多模型切换LM Studio 中切换模型Claude Desktop 无需改配置LM Studio 中Eject当前模型Load新模型 → 确认 READYClaude Desktop 保持claude-opus-4伪装名直接开始新对话因为 LM Studio 总是用当前加载模型响应伪装名只是通行证。总结核心要点预加载模型→ 避免超时尤其大模型 Cowork 模式切换 Anthropic-compatible 端点→ 协议匹配Base URL http://localhost:1234/→ 或不加后缀模型名伪装claude-opus-4→ 骗过校验Test connection 首次红色正常→ 忽略直接 ApplyCowork 模式较慢→ 大模型 显存紧张属正常现象工具调用完整支持→ 文件读取、PDF 解析均正常如果本文对你有帮助欢迎点赞收藏有问题请在评论区留言。