从零搭建本地版 Claurst：基于 Rust 重构的 Claude Code 终端编码助手 + LM Studio 模型接入测试
Kuberwastaken/claurst: Your favorite Terminal Coding Agent, now in Rust
Claurst 是一款基于 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.exe（Windows）/src-rust/target/release/claurst（Linux/macOS）； - 若提示「virtual manifest」错误：无需额外处理，直接使用编译后的二进制文件即可（无需
cargo install）。
3. 验证构建结果
powershell
# Windows 验证文件存在
dir .\target\release\claurst.exe
# Linux/macOS 验证
ls ./target/release/claurst正常输出会显示 claurst.exe（约 25MB），说明构建成功。
四、配置对接本地 LM Studio
1. 前置条件
- 启动 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 URL：
http://localhost:1234/v1（LM Studio 默认端口）； - API Key：填写你的 LM Studio 密钥（如
sk-lm-****:gZ7***i9X**ip***n）； - Model Name：直接选择列表中 LM Studio 已加载的模型（如 gemma-4-26b-a4b）；
- API Base URL：
- 按 Enter 保存配置，自动返回 Claurst 主界面。
3. 测试本地模型调用
在 Claurst 主界面输入简单指令（如 hi 或 写一个 Python 快速排序函数），验证核心功能：
- 成功标志：界面显示
Thinking+Calling LM Studio (模型名)，无「invalid x-api-key」等认证错误； - 辅助验证：查看 LM Studio 日志，能看到「Inference Request」请求记录，说明调用链路打通。
五、优化：配置全局调用（可选）
默认需输入完整路径执行 claurst.exe，可通过配置系统环境变量实现全局调用：
1. 移动可执行文件（推荐）
将 claurst.exe 放到固定目录（避免误删），例如：
plaintext
J:\PythonProjects4\tools\claurst\claurst.exe2. 添加目录到系统 PATH（Windows）
- 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量；
- 在「系统变量」中找到
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.exe（Windows） |
| 配置 LM Studio | 启动后选「LM Studio」→ 填 http://localhost:1234/v1 + 本地 API Key |
| 全局调用配置 | 把 claurst.exe 目录加入系统 PATH，重启终端后输入 claurst |
| 一键测试 | 启动后输入 hi，查看是否显示 Calling LM Studio |