Claude Code + LM Studio + CC-Switch 本地自动化编程部署指南

Claude Code LM Studio CC-Switch 本地自动化编程部署指南本指南汇总了在 Windows 本地环境下使用 Claude Code 配合 LM Studio 本地模型、CC-Switch 代理进行自动化编程开发的完整配置方案。目录硬件与模型选型LM Studio 本地模型部署CC-Switch 代理配置Claude Code 配置自动化编程工作流TMSim 项目实战模板常见问题排查一、硬件与模型选型1.1 硬件参考RTX 3060 Ti 12GB指标推荐配置GPURTX 3060 Ti 12GB显存可用约 10~11 GB系统预留 1~2GB适合模型规模7B~14BQ4_K_M 量化1.2 模型推荐按编码能力排序首选Qwen2.5-Coder-14B-Instruct项目详情量化推荐Q4_K_M约 8.5GB或Q5_K_S约 9.5GB显存占用8.5 ~ 9.5 GB编码能力当前开源编码最强之一支持 92 种编程语言3060Ti 速度Q4_K_M 约18-28 tok/sLM Studio 搜索Qwen2.5-Coder-14B-Instruct-GGUF备选Qwen3-14B项目详情量化推荐Q4_K_M约 8.4GB特点全能型支持 Thinking / Non-thinking 双模式3060Ti 速度约20-30 tok/s极速版Qwen2.5-Coder-7B项目详情量化推荐Q6_K约 6GB特点显存占用低响应极快3060Ti 速度约40-60 tok/s1.3 量化选择优先级Q4_K_M → 平衡首选推荐 Q5_K_S → 质量稍好14B 在 12GB 下仍安全 Q6_K → 7B 模型可以上14B 不建议太紧张二、LM Studio 本地模型部署2.1 下载与加载模型打开LM Studio左侧Search→ 搜索模型名称如Qwen2.5-Coder-14B-Instruct-GGUF选择lmstudio-community发布的版本下载Q4_K_M或Q5_K_S量化版本加载模型2.2 启动本地 API 服务点击左侧Developer→Start Server关键配置配置项值说明Port1234默认端口Enable CORS✅必须打开Claude Code 跨域需要API Key留空或lm-studio本地通常不强制校验确认端点可用http://localhost:1234/v1验证模型列表浏览器访问http://localhost:1234/v1/models2.3 性能优化设置加载模型后右侧设置配置项推荐值Context Length4096或8192编码任务不需要太长GPU OffloadMax全部层放 GPUBatch Size512 或 1024⚠️ 如果显存紧张Context Length 降到 4096。三、CC-Switch 代理配置3.1 CC-Switch 简介CC-Switch 是一个带 GUI 的代理工具让 Claude Code 能一键切换不同模型供应商本地 LM Studio、Kimi、DeepSeek 等。3.2 添加本地 LM Studio Provider打开 CC-Switch 桌面应用点击右上角→Add New Provider填写参数字段值Provider NameLM-Studio-Local自定义API Endpointhttp://localhost:1234/v1API Keylm-studio或任意占位符API 格式OpenAI 兼容⚠️必须选这个认证字段ANTHROPIC_AUTH_TOKEN默认⚠️关键LM Studio 的/v1端点是OpenAI 兼容格式不是 Anthropic 原生格式。如果 CC-Switch 没有 “OpenAI 兼容” 选项说明该版本不支持本地 OpenAI 模型需换claude-code-router或LiteLLM。3.3 模型映射填写本地只有一个模型三个角色都填同一个模型角色显示名称实际请求模型声明支持 1MSonnetQwen Coder 14B[LM Studio 准确ID]❌ 不勾选OpusQwen Coder 14B[LM Studio 准确ID]❌ 不勾选HaikuQwen Coder 14B[LM Studio 准确ID]❌ 不勾选获取准确模型 ID浏览器访问http://localhost:1234/v1/models复制data[0].id字段的值如qwen2.5-coder-14b-instruct必须一字不差包括大小写和连字符3.4 添加 Kimi Provider云端备选字段值Provider NameKimi-MoonshotAPI Endpointhttps://api.moonshot.cn/v1API 格式OpenAI 兼容API Key你的sk-xxxMoonshot KeySonnet/Opus 实际模型kimi-k2.6Haiku 实际模型kimi-k2.5或kimi-k2-turbo-preview⚠️kimi-k2.6默认 thinking 模式temperature 锁定为 1.0不要手动传 temperature 参数。3.5 启动代理在 CC-Switch 里启用目标 Provider确认本地代理已启动默认http://127.0.0.1:15721完全关闭CC-Switch 再重新打开确保配置生效四、Claude Code 配置4.1 settings.json 配置文件路径~/.claude/settings.jsonWindows 通常是C:\Users\你的用户名\.claude\settings.json本地模型配置LM Studio{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:15721,ANTHROPIC_AUTH_TOKEN:PROXY_MANAGED,ANTHROPIC_MODEL:qwen2.5-coder-14b-instruct,ANTHROPIC_DEFAULT_OPUS_MODEL:qwen2.5-coder-14b-instruct,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen2.5-coder-14b-instruct,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen2.5-coder-14b-instruct,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,CLAUDE_CODE_EFFORT_LEVEL:max}}Kimi 云端配置{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:15721,ANTHROPIC_AUTH_TOKEN:PROXY_MANAGED,ANTHROPIC_MODEL:kimi-k2.6,ANTHROPIC_DEFAULT_OPUS_MODEL:kimi-k2.6,ANTHROPIC_DEFAULT_SONNET_MODEL:kimi-k2.6,ANTHROPIC_DEFAULT_HAIKU_MODEL:kimi-k2.5,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,CLAUDE_CODE_EFFORT_LEVEL:max}}4.2 验证连接完全关闭终端和 Claude Code重新启动 Claude Code输入/model确认菜单显示的是你配置的模型名称测试对话hello, which model are you using now?五、自动化编程工作流5.1 核心思路让 Claude Code全自动、零干预地实现项目把设计方案作为永久上下文CLAUDE.md分阶段交付提前授权所有操作5.2 创建 CLAUDE.md 宪法文件在项目根目录创建CLAUDE.mdClaude Code 启动时会自动读取。模板结构# 项目名 — 开发宪法 ## 技术栈 - Python 3.10 - numpy, scipy, matplotlib, pytest - PyQt6UI层 ## 开发原则强制执行 1. **测试驱动**每写一个模块必须同时写对应的 pytest 单元测试 2. **零UI依赖**core/ 目录下的模块不得导入任何 GUI 库 3. **自动安装**遇到缺失依赖时自动执行 pip install 安装 4. **无需询问**直接执行所有操作不需要用户确认 ## 目录结构严格遵守 project/ ├── core/ # 模型库零UI依赖 ├── engine/ # 仿真引擎 ├── gui/ # UI可视化 ├── tests/ # 单元测试 验收测试 └── examples/ # 示例脚本 ## 实现顺序分阶段禁止跳阶段 ### Phase 1核心闭环最高优先级 - 模块 A 单元测试 - 模块 B 单元测试 - 闭环集成测试 ### Phase 2架构完善 ... ## 关键参数不可改动 - param1 xxx - param2 yyy ## 代码规范 - 使用类型注解 - 所有物理量标注单位 - 角度统一用 rad ## 权限声明 你被授权 - 读取/写入项目目录下所有文件 - 自动安装 Python 依赖 - 自动创建目录和文件 - 执行 pytest 运行测试 - 不需要询问用户确认直接执行5.3 分阶段实现策略不要一次性让它做完整项目会话目标预计时间第 1 次Phase 1核心算法 单元测试30-60 分钟第 2 次Phase 2架构 集成30-60 分钟第 3 次Phase 3扩展功能60-90 分钟第 4 次Phase 4可视化 最终集成60-90 分钟每次启动新会话时先让它Read CLAUDE.md回顾上下文然后指定当前 Phase。5.4 一键启动 Prompt保存为prompt.txt每次启动 Claude Code 时粘贴/read CLAUDE.md 请执行 Phase X替换为当前阶段 1. 自动创建所有目录和文件 2. 严格按设计文档实现代码 3. 每模块配 pytest 测试 4. 运行验收测试并自动修复至通过 5. 数值误差 2% 6. 无需询问直接执行 完成后汇报文件清单 测试结果 已知问题六、TMSim 项目实战模板6.1 项目架构四层模型┌─────────────────────────────────────────┐ │ UI可视化层PyQt6 Matplotlib │ │ ├─ 参数配置面板 │ │ ├─ 实时曲线绘制时域阶跃、频域伯德图│ │ └─ 根轨迹图 │ ├─────────────────────────────────────────┤ │ 仿真引擎层调度、积分、事件检测 │ │ ├─ 数值积分器RK4 定步长 │ │ ├─ 多速率调度器1000/200/50 Hz │ │ └─ 事件检测命中、脱靶、舵饱和 │ ├─────────────────────────────────────────┤ │ 模型库层算法核心零UI依赖 │ │ ├─ 弹体动力学线性/非线性 │ │ ├─ 舵机传感器 │ │ ├─ 过载驾驶仪2回路/PI/3回路 │ │ ├─ 制导律PN/OPN/LOS │ │ └─ 导引头 雷达 │ ├─────────────────────────────────────────┤ │ 数据管理层记录、导出、后处理 │ │ ├─ 时序记录器HDF5 │ │ └─ CSV导出 统计分析 │ └─────────────────────────────────────────┘6.2 标准数据包定义5大总线fromdataclassesimportdataclassfromtypingimportOptionaldataclassclassTrueStateBus:1000Hz来自六自由度积分器timestamp:floatpos_x:float;pos_y:float;pos_z:floatvel_x:float;vel_y:float;vel_z:floatroll:float;pitch:float;yaw:floatomega_x:float;omega_y:float;omega_z:floatlos_angle:float;range_:float;range_rate:floatdataclassclassNavDataBus:200Hz来自传感器组件timestamp:floataccel_y_meas:floatomega_z_meas:floatlos_angle_rate_est:floatdataclassclassGuidanceCmdBus:50Hz来自制导律timestamp:floatay_cmd:floataz_cmd:floatgamma_cmd:floatt_go:Optional[float]NonedataclassclassActuatorCmdBus:200Hz来自驾驶仪timestamp:floatdelta_x:float;delta_y:float;delta_z:floatdataclassclassForceMomentBus:1000Hz来自舵机动力学timestamp:floatforce_x:float;force_y:float;force_z:floatmoment_x:float;moment_y:float;moment_z:float6.3 关键教材参数不可改动# 弹体线性化参数表4.1-1a_alpha72.4# s^-2a_delta471.0# s^-2a_omega1.5# s^-2b_alpha1.27# s^-1b_delta0.477# s^-1c0.66# mV1140.0# m/s# 驾驶仪参数两回路K_A0.00065# s^2/(m·N)K_g0.0728# s# 舵机参数k_r-0.0175tau0.0133# s6.4 验收标准Week 1# 图4.1-8 单位阶跃过载响应# 条件1初始下冲t0.05sassert-0.25ay_down-0.15# 条件2稳态值t0.4sassert0.78ay_ss0.80# 条件3调节时间assertt_settle0.4# 条件4无NaNassertnotnp.isnan(ay_array).any()七、常见问题排查7.1 CC-Switch 相关问题问题原因解决没有 “OpenAI 兼容” 选项版本只支持 Anthropic 后端换claude-code-router或LiteLLM401 Invalid AuthenticationKey 错误或端点混用确认端点和 Key 匹配404 Model Not Found模型 ID 拼写错误从http://localhost:1234/v1/models复制准确名称400 invalid temperaturekimi-k2.6 默认 thinking 模式锁定 temperature1.0不传 temperature 参数或换模型7.2 LM Studio 相关问题问题原因解决CORS 错误LM Studio 没开 CORSDeveloper → 勾选 Enable CORS模型加载失败显存不足换更小的量化版本或减小 Context Length响应极慢GPU Offload 不够右侧设置 GPU Offload 拉到 Max7.3 Claude Code 相关问题问题原因解决pip: command not found环境 PATH 问题用python -m pip代替测试一直失败实现逻辑错误暂停测试先检查数学公式推导想改参数让测试通过参数是宪法制止参数不可改只能改代码上下文溢出文件太多重启会话基于已有代码继续7.4 本地模型 Tool Calling 问题Qwen 本地量化版在 Claude Code 的 agentic 模式自动读写文件、执行命令下可能不稳定Failed to parse tool call: Unexpected end of content. Failed to parse tool call: Expected name, but got name at index 13.解决这是模型输出格式不符合 Claude Code 的 XML tool use 格式换更强的模型14B 比 7B 稳定或降低任务复杂度分步执行附录替代工具如果 CC-Switch 不满足需求可考虑工具定位安装claude-code-proxyClaude Code 专用原生支持 Kimi Codebrew install raine/claude-code-proxy/claude-code-proxyclaude-code-router本地模型专用支持 LM Studio/Ollamanpm install -g musistudio/claude-code-routerUniClaudeProxy通用全能支持任意后端pip install uniclaudproxyLiteLLM企业网关100 模型pip install litellm文档版本v1.0更新日期2026-05-24