### 1、如何安装（或更新升级）

#### 系统要求

- **Java 8+**（支持 Java 8 到 Java 26 环境，需要提前安装好）
- 支持 macOS、Linux、Windows

#### 在线安装命令

```bash
# Mac / Linux:
curl -fsSL https://solon.noear.org/soloncode/setup.sh | bash

# Windows (PowerShell):
irm https://solon.noear.org/soloncode/setup.ps1 | iex
```

#### 离线安装参考

* [【SolonCode CLI 学习7 - 如何离线安装？】](https://www.bilibili.com/video/BV1pmQEB9Eio/)

#### 安装目录结构

```
~/.soloncode/
+-- AGENTS.md           # 智能体定义（升级时保留）
+-- config.yml          # 配置文件（升级时保留）
+-- bin/                    # 可执行文件目录
|   +-- soloncode-cli.jar   # 核心程序
|   +-- soloncode           # Linux/macOS 启动脚本
|   +-- soloncode.ps1       # PowerShell 启动脚本
|   +-- uninstall.sh          # Linux/macOS 卸载脚本
|   +-- uninstall.ps1         # PowerShell 卸载脚本
+-- skills/                 # 全局技能目录
```

#### 首次安装后配置

安装完成后，需修改配置文件 `~/.soloncode/config.yml`：

1. 找到 `models` 配置项（支持多模型配置，第一个为默认）
2. 配置你的 AI 模型 API（支持 OpenAI、DeepSeek、通义千问等）
3. 详细配置参考：[《模型配置与请求选项》](/article/1087)

```yaml
soloncode:
  models:
    - apiUrl: "https://api.deepseek.com/v1/chat/completions"
      apiKey: "sk-xxxxxx"
      model: "deepseek-chat"
      timeout: "180s"
```

#### 升级说明

重新执行安装命令即可升级：

- `config.yml` 配置文件 **自动保留**
- `AGENTS.md` 智能体定义 **自动保留**
- 其他文件会被更新


### 2、如何卸载

```bash
# Mac / Linux
sh ~/.soloncode/bin/uninstall.sh

# Windows (PowerShell)
& "$HOME/.soloncode/bin/uninstall.ps1"
```


### 3、快速验证（以 mac 为例）

配置完成后，打开终端验证：

运行：`soloncode`（cli 交互） 或者 `soloncode web 0`（web 交互）


<img src="/img/1851c8c77af94319b56af2ef1e80035d.png" width="500" />