从零搭建本地版 Claurst：基于 Rust 重构的 Claude Code 终端编码助手 + LM Studio 模型接入测试

从零搭建本地版 Claurst基于 Rust 重构的 Claude Code 终端编码助手 LM Studio 模型接入测试Kuberwastaken/claurst: Your favorite Terminal Coding Agent, now in RustClaurst 是一款基于 Rust 重构的开源终端编码助手复刻了 Claude Code 的核心交互逻辑同时支持多 AI 提供商、本地大模型对接等增强特性。本文将完整复盘从项目克隆、源码构建到配置对接本地 LM Studio 大模型的全流程帮助你快速搭建一套「离线、私密、高性能」的终端编码助手。一、项目背景Claurst 是 Claude Code 的 Rust 纯重构版本核心优势开源无追踪无 telemetry、无数据上报完全本地化运行多提供商兼容支持 Anthropic、OpenAI、LM Studio、Ollama 等 30 服务商高性能Rust 编写启动快、内存占用低终端交互友好TUI 界面复刻 Claude Code 操作体验支持代码对话、项目级协作。本次实操目标基于源码构建 Claurst并对接本地 LM Studio 运行的大模型如 gemma-4-26b-a4b、qwen3-coder-30b实现完全离线的终端编码助手。二、环境准备1. 基础依赖Rust 开发环境需安装rustup推荐 stable 版本用于编译源码LM Studio已安装并配置本地推理服务器默认端口 1234且加载目标大模型终端工具Windows 推荐 PowerShell管理员权限Linux/macOS 用默认终端即可网络构建阶段需联网拉取 Rust 依赖运行阶段可完全离线。2. 验证 Rust 环境powershell# 检查 Rust 版本确保无工具链损坏 rustc -V cargo -V # 若提示「rustc.exe 不适用于 stable-x86_64-pc-windows-msvc」修复工具链 rustup toolchain uninstall stable rustup toolchain install stable三、源码克隆与构建1. 克隆项目powershell# 克隆仓库到本地 git clone https://github.com/kuberwastaken/claurst.git cd claurst/src-rust # 进入 Rust 源码目录2. 编译构建Claurst 采用 Cargo 管理构建核心命令powershell# 编译 release 版本优化性能生成可执行文件 cargo build --release --package claurst构建成功后可执行文件路径src-rust/target/release/claurst.exeWindows/src-rust/target/release/claurstLinux/macOS若提示「virtual manifest」错误无需额外处理直接使用编译后的二进制文件即可无需cargo install。3. 验证构建结果powershell# Windows 验证文件存在 dir .\target\release\claurst.exe # Linux/macOS 验证 ls ./target/release/claurst正常输出会显示claurst.exe约 25MB说明构建成功。四、配置对接本地 LM Studio1. 前置条件启动 LM Studio加载目标大模型如 gemma-4-26b-a4b开启 LM Studio 的「Local Inference Server」确认端口为 1234默认记录 LM Studio 的 API Key格式如sk-lm-*****:gZ7d*****1i9XC******。2. 启动 Claurst 并配置提供商步骤 1执行二进制文件或者直接在目录中双击打开PowerShell 中需显式指定当前目录安全机制避免「命令未找到」错误powershell# 回到 claurst 根目录 cd .. # 执行编译后的文件Windows .\src-rust\target\release\claurst.exe步骤 2可视化配置 LM Studio 连接启动后 Claurst 会弹出「Connect a provider」配置窗口按以下操作向下滚动找到「LM Studio (Local model server)」标注 LOCAL按 Enter 选中填写连接信息API Base URLhttp://localhost:1234/v1LM Studio 默认端口API Key填写你的 LM Studio 密钥如sk-lm-****:gZ7***i9X**ip***nModel Name直接选择列表中 LM Studio 已加载的模型如 gemma-4-26b-a4b按 Enter 保存配置自动返回 Claurst 主界面。3. 测试本地模型调用在 Claurst 主界面输入简单指令如hi或写一个 Python 快速排序函数验证核心功能成功标志界面显示ThinkingCalling LM Studio (模型名)无「invalid x-api-key」等认证错误辅助验证查看 LM Studio 日志能看到「Inference Request」请求记录说明调用链路打通。五、优化配置全局调用可选默认需输入完整路径执行claurst.exe可通过配置系统环境变量实现全局调用1. 移动可执行文件推荐将claurst.exe放到固定目录避免误删例如plaintextJ:\PythonProjects4\tools\claurst\claurst.exe2. 添加目录到系统 PATHWindows右键「此电脑」→ 属性 → 高级系统设置 → 环境变量在「系统变量」中找到Path双击编辑点击「新建」粘贴claurst.exe所在目录如J:\PythonProjects4\tools\claurst保存并重启终端即可在任意目录输入claurst启动。3. 临时全局调用仅当前终端有效powershell# Windows PowerShell $env:PATH ;J:\PythonProjects4\claurst claurst # 直接调用六、常见问题与避坑1. 「Authentication error: invalid x-api-key」原因误配置 Anthropic 官方 API Key或未选择 LM Studio 提供商解决通过/connect切换到 LM Studio 提供商填写本地 API Key无需 Anthropic 密钥。2. 终端乱码如[M#C[M#CA...原因ANSI 颜色码渲染问题不影响核心功能解决双击 .exe 文件重新配置或更换终端如 Windows Terminal优化渲染。3. PowerShell 提示「claurst 未被识别」原因未显式指定路径或环境变量未生效解决用.\claurst.exe执行或重启终端使 PATH 配置生效。七、最终成果通过以上步骤你已完成从源码编译出高性能的 Rust 版 Claurst成功对接本地 LM Studio 大模型脱离官方服务器依赖实现「离线、私密、无认证限制」的终端编码助手可选配置全局调用提升使用便捷性。Claurst 支持代码解释、功能开发、Bug 修复等核心编码场景结合本地大模型可完全规避网络、隐私、费用等问题是终端开发者的高效辅助工具。附核心命令速查操作命令 / 步骤源码构建cargo build --release --package claurst本地执行.\src-rust\target\release\claurst.exeWindows配置 LM Studio启动后选「LM Studio」→ 填http://localhost:1234/v1 本地 API Key全局调用配置把 claurst.exe 目录加入系统 PATH重启终端后输入claurst一键测试启动后输入hi查看是否显示Calling LM Studio