企业官网建设流程全解析

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

本指南汇总了在 Windows 本地环境下，使用 Claude Code 配合 LM Studio 本地模型、CC-Switch 代理进行自动化编程开发的完整配置方案。

目录

1. 硬件与模型选型
2. LM Studio 本地模型部署
3. CC-Switch 代理配置
4. Claude Code 配置
5. 自动化编程工作流
6. TMSim 项目实战模板
7. 常见问题排查

一、硬件与模型选型

1.1 硬件参考（RTX 3060 Ti 12GB）

1.2 模型推荐（按编码能力排序）

首选：Qwen2.5-Coder-14B-Instruct

备选：Qwen3-14B

极速版：Qwen2.5-Coder-7B

1.3 量化选择优先级

Q4_K_M → 平衡首选（推荐） Q5_K_S → 质量稍好，14B 在 12GB 下仍安全 Q6_K → 7B 模型可以上，14B 不建议（太紧张）

二、LM Studio 本地模型部署

2.1 下载与加载模型

1. 打开LM Studio
2. 左侧Search→ 搜索模型名称（如Qwen2.5-Coder-14B-Instruct-GGUF）
3. 选择lmstudio-community发布的版本
4. 下载Q4_K_M或Q5_K_S量化版本
5. 加载模型

2.2 启动本地 API 服务

1. 点击左侧Developer→Start Server
2. 关键配置：

3. 确认端点可用：

http://localhost:1234/v1

4. 验证模型列表（浏览器访问）：

http://localhost:1234/v1/models

2.3 性能优化设置

加载模型后，右侧设置：

⚠️ 如果显存紧张，Context Length 降到 4096。

三、CC-Switch 代理配置

3.1 CC-Switch 简介

CC-Switch 是一个带 GUI 的代理工具，让 Claude Code 能一键切换不同模型供应商（本地 LM Studio、Kimi、DeepSeek 等）。

3.2 添加本地 LM Studio Provider

1. 打开 CC-Switch 桌面应用
2. 点击右上角+→Add New Provider
3. 填写参数：

⚠️关键：LM Studio 的/v1端点是OpenAI 兼容格式，不是 Anthropic 原生格式。如果 CC-Switch 没有 “OpenAI 兼容” 选项，说明该版本不支持本地 OpenAI 模型，需换claude-code-router或LiteLLM。

3.3 模型映射填写

本地只有一个模型，三个角色都填同一个：

获取准确模型 ID：

• 浏览器访问http://localhost:1234/v1/models
• 复制data[0].id字段的值（如qwen2.5-coder-14b-instruct）
• 必须一字不差，包括大小写和连字符

3.4 添加 Kimi Provider（云端备选）

⚠️kimi-k2.6默认 thinking 模式，temperature 锁定为 1.0，不要手动传 temperature 参数。

3.5 启动代理

1. 在 CC-Switch 里启用目标 Provider
2. 确认本地代理已启动（默认http://127.0.0.1:15721）
3. 完全关闭CC-Switch 再重新打开（确保配置生效）

四、Claude Code 配置

4.1 settings.json 配置

文件路径：~/.claude/settings.json（Windows 通常是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 验证连接

1. 完全关闭终端和 Claude Code
2. 重新启动 Claude Code
3. 输入：

/model

确认菜单显示的是你配置的模型名称

4. 测试对话：

hello, which model are you using now?

五、自动化编程工作流

5.1 核心思路

让 Claude Code全自动、零干预地实现项目：

• 把设计方案作为永久上下文（CLAUDE.md）
• 分阶段交付
• 提前授权所有操作

5.2 创建 CLAUDE.md 宪法文件

在项目根目录创建CLAUDE.md，Claude Code 启动时会自动读取。

模板结构：

# 项目名 — 开发宪法 ## 技术栈 - Python 3.10+ - numpy, scipy, matplotlib, pytest - PyQt6（UI层） ## 开发原则（强制执行） 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 分阶段实现策略

不要一次性让它做完整项目！

每次启动新会话时，先让它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大总线）

fromdataclassesimportdataclassfromtypingimportOptional@dataclassclassTrueStateBus:"""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:float@dataclassclassNavDataBus:"""200Hz，来自传感器组件"""timestamp:floataccel_y_meas:floatomega_z_meas:floatlos_angle_rate_est:float@dataclassclassGuidanceCmdBus:"""50Hz，来自制导律"""timestamp:floatay_cmd:floataz_cmd:floatgamma_cmd:floatt_go:Optional[float]=None@dataclassclassActuatorCmdBus:"""200Hz，来自驾驶仪"""timestamp:floatdelta_x:float;delta_y:float;delta_z:float@dataclassclassForceMomentBus:"""1000Hz，来自舵机动力学"""timestamp:floatforce_x:float;force_y:float;force_z:floatmoment_x:float;moment_y:float;moment_z:float

6.3 关键教材参数（不可改动）

# 弹体线性化参数（表4.1-1）a_alpha=72.4# s^-2a_delta=471.0# s^-2a_omega=1.5# s^-2b_alpha=1.27# s^-1b_delta=0.477# s^-1c=0.66# mV=1140.0# m/s# 驾驶仪参数（两回路）K_A=0.00065# s^2/(m·N)K_g=0.0728# s# 舵机参数k_r=-0.0175tau=0.0133# s

6.4 验收标准（Week 1）

# 图4.1-8 单位阶跃过载响应# 条件1：初始下冲（t=0.05s）assert-0.25<ay_down<-0.15# 条件2：稳态值（t>0.4s）assert0.78<ay_ss<0.80# 条件3：调节时间assertt_settle<0.4# 条件4：无NaNassertnotnp.isnan(ay_array).any()

七、常见问题排查

7.1 CC-Switch 相关问题

7.2 LM Studio 相关问题

7.3 Claude Code 相关问题

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 不满足需求，可考虑：

文档版本：v1.0
更新日期：2026-05-24