> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> 配置 OpenCode CLI、本地 opencode.json 或第三方供应商。

OpenCode 走本机 `opencode`。打开 **设置 → CLI配置管理 → OpenCode CLI** 检测版本、安装，并配置凭证。

## 接入方式

1. **使用本地配置**：直接读 `~/.config/opencode/opencode.json`（也支持 `.jsonc`）。优先读 `$OPENCODE_CONFIG`
2. **添加供应商**：名称、Base URL、API Key、模型列表
3. 可覆盖 `opencode` 可执行文件路径
4. 可把该引擎放到 **未启用**，输入框里就不再出现
5. 未安装时在该页点 **安装**，或按下面的终端命令安装

OpenCode 的托管供应商走环境注入，**不会改** `opencode.json`。登录与会话仍以 OpenCode 自己的配置为准。

<Note>
  配置只存在你的电脑上。客户端不会把 Key 上传到 CC GUI 自己的服务器。
</Note>

## 添加供应商

点 **添加**，填：

* 名称、Base URL、API Key
* 模型列表（逗号分隔；留空则不限制）
* 可选：备注

快捷预设：OpenCode Zen（官方）。

## 安装

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
opencode --version
```

备选：

```bash theme={null}
npm install -g opencode-ai
```

应用内 **安装** 预览的是备选里的 `npm install -g opencode-ai`。客户端不提供 OpenCode 卸载，以免误删登录与会话数据。

文档：[https://opencode.ai/docs/](https://opencode.ai/docs/)

## 能力差异

相对 Claude Code：

* 没有规划模式
* 不走客户端 MCP
* 支持会话续写与图片输入
* 停止按钮会结束 `opencode` 子进程
* 历史按 runtime 隔离

## 检测失败时

见 [检测与安装](/desktop/providers/cli)。

## 下一步

* [多供应商总览](/desktop/providers/overview)
* [发出第一条消息](/desktop/start/first-task)