SolonCode 是不是国产化替代 ClaudeCode 的优选？

安全审计、代码脱敏、数据本地化，是国内企业换掉 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 / 鸿蒙 PC：

curl -fsSL https://solon.noear.org/soloncode/setup.sh | bash

Windows（PowerShell）：

irm https://solon.noear.org/soloncode/setup.ps1 | iex

重复执行安装命令即可更新，安装器会更新程序文件，且保留你的配置或定义文件。

3.3 离线安装（内网 / 信创隔离环境）

如果目标机器没有外网，采用「一台联网机器下载 + 拷贝到目标机器安装」的方式：

第一步： 在联网机器下载最新版安装包

用浏览器打开 Gitee Releases 页面 手动下载 soloncode-cli-bin-*.tar.gz。

第二步： 拷贝到目标机器并解压

通过 U 盘、scp、内网共享等任意方式，把 tar.gz 传到目标机器，然后解压（里面有 install 安装脚本）。

第三步： 运行安装脚本

Mac / Linux / 鸿蒙 PC：

sh install.sh

Windows（PowerShell）：

& "./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 web 0

打开浏览器后进入「设置 → 大语言模型」，添加模型并测试连接。

3.6 快速验证

soloncode cli

进入 CLI 后可以输入：

你好啊

也可以启动 Web 模式：

soloncode web        # 默认端口 4808
soloncode web 0      # 自动选择可用端口
soloncode web 1212   # 指定端口

3.7 卸载

Mac / Linux：

sh ~/.soloncode/bin/uninstall.sh

Windows（PowerShell）：

& "$HOME/.soloncode/bin/uninstall.ps1"

3.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 自定义规约，团队共享的工程规范会被智能体自动读取并遵守。

五、总结

SolonCode 的定位很明确：把 AI 编码能力从海外模型换到国产模型，让数据不出境、让团队用中文、让工程线不重写。

如果你正在寻找一个：

• 模型可接 DeepSeek/QWen/GLM 等国产 API
• 代码、对话、记忆全链路不出境
• 中文界面开箱即用
• 安装简单、离线可用、内网部署无障碍

的编码智能体，SolonCode 是目前国内最完整、最接地气的方案。