安全审计、代码脱敏、数据本地化是国内企业换掉 ClaudeCode或任何海外 AI 编码助手的三条真实理由。但「能换」和「换得舒服」之间还隔着很多具体细节——安装、配置、模型选择、代码理解能力、与既有工程线的兼容性一项项都比较清楚才能判断谁才是「最优」。本文不喊口号逐条对照结论在最后。二、SolonCode 是什么SolonCode 是杭州无耳科技从零构建的企业级终端编码智能体底层架构自研全中文驱动。它的定位一个soloncode web 0命令启动 Web 工作台浏览器打开即可用。自主理解需求、规划步骤、编写代码、执行 Shell。模型不绑定支持 DeepSeek、QWen、GLM、Kimi、MiniMax、GPT、Claude、Gemini、Ollama 等也可以接内部私有化网关。开源GitHub / Gitee / GitCode 三端支持 macOS / Linux / Windows / 鸿蒙 PC。预览三、安装详解3.1 系统要求需要 Java 8 或更高版本支持 Java 8 到 Java 26提前安装好即可。3.2 在线安装推荐Mac / Linux / 鸿蒙 PCcurl-fsSLhttps://solon.noear.org/soloncode/setup.sh|bashWindowsPowerShellirmhttps://solon.noear.org/soloncode/setup.ps1|iex重复执行安装命令即可更新安装器会更新程序文件且保留你的配置或定义文件。3.3 离线安装内网 / 信创隔离环境如果目标机器没有外网采用「一台联网机器下载 拷贝到目标机器安装」的方式第一步在联网机器下载最新版安装包用浏览器打开 Gitee Releases 页面 手动下载soloncode-cli-bin-*.tar.gz。第二步拷贝到目标机器并解压通过 U 盘、scp、内网共享等任意方式把tar.gz传到目标机器然后解压里面有install安装脚本。第三步运行安装脚本Mac / Linux / 鸿蒙 PCshinstall.shWindowsPowerShell./install.ps1安装脚本会把程序文件写入~/.soloncode/并尝试将soloncode命令注册到 PATH。3.4 安装后的目录结构~/.soloncode/ -- AGENTS.md # 全局智能体提示词 -- settings.json # Web 设置页维护的全局配置 -- bin/ | -- soloncode-cli.jar | -- soloncode | -- soloncode.ps1 | -- uninstall.sh | -- uninstall.ps1 | -- uninstall.cmd -- skills/ # 全局 Skills -- agents/ # 全局子代理 -- commands/ # 全局自定义命令 -- extensions/ # Java 扩展插件 -- memory/ # 全局长期记忆默认项目目录下还可以有工作区配置project-root/ -- .soloncode/ -- settings.json -- AGENTS.md -- CODE.md -- sessions/ -- skills/ -- agents/ -- commands/ -- logs/3.5 首次配置模型soloncode web0打开浏览器后进入「设置 → 大语言模型」添加模型并测试连接。3.6 快速验证soloncode cli进入 CLI 后可以输入你好啊也可以启动 Web 模式soloncode web# 默认端口 4808soloncode web0# 自动选择可用端口soloncode web1212# 指定端口3.7 卸载Mac / Linuxsh~/.soloncode/bin/uninstall.shWindowsPowerShell$HOME/.soloncode/bin/uninstall.ps13.8 常见问题问题建议soloncode命令找不到重新安装。或检查安装脚本是否已写入 PATH模型连接失败检查apiUrl、apiKey、模型名与网络代理Web 端口被占用使用soloncode web 0或指定其他端口四、SolonCode 的主要特点4.1 全中文驱动的交互体验SolonCode 从底层到界面都面向中文用户设计。全中文界面所有菜单、设置、提示、帮助文档均为中文模型配置的完整路径是设置 → 模型 → 添加模型填 API URL、API Key、模型名→ 测试连接22 种界面语言除了简繁中文还支持英日韩、德法西意俄葡以及阿拉伯语、孟加拉语、挪威语等小语种默认跟随系统语言。切换语言无需重启即时生效。字体与字号自由调节v2026.8.4 起支持界面字体 12 个候选可搜索代码字体独立选择字号 85%~150% 无级缩放字体与布局解耦放大文字不会撑变形。4.2 模型不绑定国产模型优先支持SolonCode 不绑定任何单一模型用户可以自由选择DeepSeek目前国内性价比最高的通用模型之一编码任务效果接近 GPT-4 级别。QWen / GLM / Kimi国产主流模型都有免费额度。Ollama 私有部署企业内网离线运行数据完全不出门成本仅为电力。GPT / Claude / Gemini如需使用海外模型也可以接入完全自主。模型切换在 Web 面板里点一下就好不需要改代码或重新部署。代码、对话、记忆全部不出境对于金融、政务、军工等强监管行业这是基础能力不是选配。4.3 心智记忆 Web 化SolonCode 内置长期记忆能力记忆条目在 Web 界面中直接维护按重要度与时间浏览所有记忆语义检索精准定位历史经验条目上百后也能快速找回记忆是团队的资产不是个人的——不同会话可以共享同一份记忆库项目级的知识沉淀自动复用。4.4 代码理解与工程能力底层架构从零构建自研 ReActAgent 推理引擎具备角色与指令系统可以给智能体设定明确的角色和任务指令。子代理管理内置bash、explore、general、plan四个子代理除general外均无写权限边界划在配置里。ReAct 反思循环执行 → 观察 → 反思 → 再执行的闭环允许中途纠正方向。/goal简化命令一键定义目标智能体自主拆解任务。实测案例v2026.8.3 版本的 15 分钟第一次成功指南记录了一个真实团队从零安装到产出可审查代码变更的完整路径包含测试连接、模型配置、进入项目目录、下达代码审查指令、查看 Diff 四个环节全部可截图验证。4.5 与现有工程线无缝兼容SolonCode 支持主流编程语言和框架不强制要求特定技术栈构建工具Maven、Gradle、npm、pnpm、yarn、Go Modules 等语言Java、Python、Go、JavaScript/TypeScript、Kotlin、C# 等操作系统macOS、Linux、Windows、鸿蒙 PC项目目录下可以放置.soloncode/CODE.md自定义规约团队共享的工程规范会被智能体自动读取并遵守。4.6 多工作区隔离架构SolonCode 支持同时运行多个独立工作区每个工作区拥有专属的引擎实例、会话历史、记忆库和工具配置彼此完全隔离。工作原理工作区 ID 由物理路径的 MD5 哈希生成格式ws-xxx确保同一目录永远映射到同一工作区每个工作区维护独立的HarnessEngine、SessionManager、FileService、GitService实例历史记录持久化在~/.soloncode/workspaces.json支持快速切换最近工作区LRU 闲置释放机制30 分钟无访问且无 WebSocket 连接的工作区会自动释放资源使用场景同时维护多个项目互不干扰不同项目使用不同模型或配置跨项目知识沉淀通过全局记忆共享4.7 结构化任务列表SolonCode 内置TodoTalent支持在长链路任务中使用结构化任务清单管理进度。核心能力todowrite工具创建、更新、重构完整 Markdown 格式任务清单todoread工具读取当前任务状态同步进度状态标记- [ ]待办、- [/]进行中、- [x]已完成任务持久化每个会话的 TODO 列表保存在sessions/{sessionId}/TODO.md典型工作流- [ ] 需求分析 - [ ] 架构设计 - [/] 编码实现 - [ ] 单元测试 - [x] 代码审查前端实时渲染任务卡片支持按状态过滤。AI 管家在复杂任务中会自动拆解子任务、实时更新进度用户可随时查看全局状态。4.8 安全沙盒模式SolonCode 默认启用沙盒模式为 AI 编码操作提供安全边界防止误操作影响系统稳定性。沙盒配置项Settings → General配置项默认值说明sandboxModetrue是否启用沙盒sandboxAllowUserHometrue是否允许访问用户主目录sandboxSystemRestrictfalse是否启用系统级接口限制沙盒保护范围禁止执行pkill java、kill -9等危险进程操作禁止执行exit命令退出子进程禁止删除根目录或系统目录/etc、/usr等禁止修改网络配置或安装系统驱动所有命令在 Java 进程子 shell 中运行杀死父进程会导致智能体停止适用场景团队协作多人共用同一台机器时防止 AI 误操作影响他人生产环境在内网服务器部署时降低风险新手用户学习 AI 编码时的安全网4.9 文件挂载与逻辑路径SolonCode 支持将任意目录挂载为逻辑路径通过alias前缀在命令中引用实现跨目录、跨项目的统一访问。挂载类型类型说明典型用途FILES文件/目录挂载源码仓库、文档库、数据目录SKILLS技能包挂载自定义技能、模板库AGENTS子代理挂载共享的子代理定义使用方式# 在设置中配置挂载点# alias: solon-ai-source, path: /path/to/solon-ai, type: FILES, writeable: false# 在命令中使用逻辑路径读取文件 solon-ai-source/solon-ai-core/src/main/java/.../ChatModel.java# 在代码理解中自动解析greppattern solon-ai-source/src/lssolon-ai-source/动态挂载管理挂载点变更时自动触发文件监听实时同步到前端支持启用/停用单个挂载点不影响其他挂载挂载点权限独立配置read-only / read-write文件树浏览支持挂载别名作为根节点典型配置示例{mountPools:{solon-ai-source:{description:solon-ai 开源项目仓库源代码,type:FILES,path:/Users/dev/repos/solon-ai,writeable:false,scope:user},workspace-skills:{description:工作区技能包,type:SKILLS,path:./.soloncode/skills,writeable:true,scope:workspace}}}挂载机制让 SolonCode 能够访问项目外的参考源码、共享技能库同时保持工作区边界的清晰性。4.10 定时心跳循环任务SolonCode 支持定时心跳循环任务让 AI 可以按固定间隔或 cron 表达式自主执行巡检、监控、轮询类任务无需人工干预。创建心跳任务/loop 5m checkifdeployment finished# 每 5 分钟执行一次/loop 30s check CI status# 每 30 秒自动向上取整为 1 分钟/loop check CI status# 默认 5 分钟/loop cron:0 */5 * * * ?check status# 使用 cron 表达式/loop 5m--nowcheck status# 立即执行首次管理命令命令说明/loop列出当前会话所有活跃任务/loop stop id停止指定任务/loop stop-all停止当前会话所有任务适用场景定时检查 CI/CD 构建状态轮询部署进度周期性备份验证监控系统告警心跳任务持久化在会话目录的loop-tasks.json中进程重启后自动恢复调度。4.11 目标驱动Goal模式除了定时心跳SolonCode 还支持目标驱动模式Goal——设定一个目标AI 自主推进直至达成无需逐轮人工介入。这是 SolonCode 实现自主持续运行的核心能力。创建 Goal 任务/loop goal fix auth module# 简化 Goal 模式立即执行/loop goalwritea readme.md# 编写文档/loop goal --max-tokens:50000 refactor# 限制 Token 预算/loop goal --max-duration:30 fix tests# 限制时间预算分钟Goal 状态机Goal 模式拥有完整的6 态状态机实现可中断、可恢复的自主推进PURSUING ⇄ PAUSED → ACHIEVED | BUDGET_LIMITED | ITERATION_LIMITED ↓ BLOCKED → (resume) → PURSUING状态说明可恢复PURSUING正在推进中AI 持续执行—PAUSED用户手动暂停/loop pause是BLOCKEDAI 主动声明阻塞通过goal_update(blocked)是ACHIEVEDAI 调用goal_update(complete)标记完成否终态BUDGET_LIMITEDToken/时间预算耗尽可通过扩容恢复ITERATION_LIMITED轮次预算耗尽否终态管理命令命令说明/loop pause id暂停一个 Goal 任务/loop resume id恢复暂停/阻塞的 Goal 任务/loop stop id停止任务AI 侧工具动态暴露Goal 模式下系统向 AI 暴露两个工具仅在存在活跃 Goal 时加载工具说明goal_get查询当前 Goal 状态目标、进度、预算消耗、耗时goal_update标记完成complete或声明阻塞blocked预算管理Goal 模式支持 Token 和时间双重预算控制配置说明默认值--max-tokens:NToken 预算上限settings.json中配置--max-duration:N时间预算上限分钟settings.json中配置预算阈值体系警告阈值默认 70%引导词中提示 AI 调整策略紧急阈值默认 85%引导词中增加紧急提示预算耗尽触发 wrap-up 收尾回合AI 总结进展后状态转为 BUDGET_LIMITED预算感知引导词Budget-Aware Prompting剩余预算引导词模式章节数≥ 30%完整模式7 章节证据驱动、忠于目标、审计完成、阻塞审计等15% ~ 30%精简模式3 章节目标延续、审计完成、上一轮摘要 15%极简模式单段落运行时兜底机制机制说明无进展检测通过指纹对比工具调用 结果长度桶 行数桶检测停滞连续 3 轮无进展则触发告警连续异常重试异常时递增延迟重试5s → 10s → 15s…连续 3 次后标记 BLOCKED事件驱动续行Goal 每轮执行完成后自动调度下一轮1s 冷却间隙ShutdownHookJVM 关闭时自动暂停所有活跃 Goal崩溃恢复进程重启后自动恢复未过期任务自动 resume 暂停/阻塞的 GoalGoal 验证器当 AI 调用goal_update(complete)标记目标完成时系统会先执行客观验证默认验证器NoopValidator始终返回通过自定义验证器可注册实现GoalValidator接口的验证器执行如运行测试套件、检查文件存在等客观校验插件化通过ValidatorFactory根据目标条件自动匹配验证器验证失败时系统会返回错误信息AI 继续改进后重新提交。完整示例# 每隔 5 分钟检查构建状态/loop 5m checkifthe CI build passed# 查看所有任务/loopls# 发现构建失败创建 Goal 任务修复/loop goal --max-tokens:50000 fix the CI build failure# 查看 Goal 进展/loopls# 临时暂停 Goal/loop pause a1b2c3d4# 恢复 Goal/loop resume a1b2c3d4# Goal 完成后停止定时检查/loop stop b2c3d4e5提示每个会话同一时间只能有一个活跃的 Goal。需先/loop stop id才能创建新 Goal。与/continue的区别特性/loop goal/continue驱动方式事件驱动自动持续推进手动触发状态管理完整状态机暂停/恢复/完成/预算无状态管理预算控制Token 时间预算无预算持久化自动持久化进程重启可恢复仅恢复会话历史适用场景需要多轮自主完成的复杂任务从上一次中断处继续聊天五、总结SolonCode 的定位很明确把 AI 编码能力从海外模型换到国产模型让数据不出境、让团队用中文、让工程线不重写。如果你正在寻找一个模型可接 DeepSeek/QWen/GLM 等国产 API代码、对话、记忆全链路不出境中文界面开箱即用安装简单、离线可用、内网部署无障碍的编码智能体SolonCode 是目前国内最完整、最接地气的方案。