My Docs

Appearance

OpenCode 配置指南 ​

本页包含 OpenCode 的安装方式与配置步骤，适用于 Windows / macOS / Linux。

安装 OpenCode ​

Windows（任选其一） ​

bash
choco install opencode
bash
scoop bucket add extras
scoop install extras/opencode
bash
npm install -g opencode-ai
bash
mise use -g ubi:sst/opencode
bash
docker run -it --rm ghcr.io/sst/opencode

注：Windows 上的 Bun 安装支持仍在进行中；也可以从官方 Releases 下载二进制文件。

更多安装方式可查看官方安装文档：https://opencode.ai/docs/

macOS / Linux（任选其一） ​

bash
curl -fsSL https://opencode.ai/install | bash
bash
brew install opencode
bash
npm install -g opencode-ai

Arch Linux 可用：

bash
paru -S opencode-bin

更多安装方式可查看官方安装文档：https://opencode.ai/docs/

配置文件位置 ​

OpenCode 的全局配置文件路径是：

~/.config/opencode/opencode.json

Windows 等价路径：

%USERPROFILE%\.config\opencode\opencode.json

更多配置说明可查看官方配置文档：https://opencode.ai/docs/config/

你也可以在项目根目录放置 opencode.json 作为项目级配置（优先级更高）。

准备 opencode.json ​

从本站下载配置文件：

请务必把文件中的 apiKey 替换成你的真实 key。

手动配置（推荐所有平台） ​

  1. 新建目录：%USERPROFILE%\.config\opencode（macOS / Linux 则是 ~/.config/opencode）
  2. 将 opencode.json 复制为 opencode.json 到上面目录
  3. 编辑文件，将 apiKey 改成你的真实 key

自动配置脚本（可选） ​

以下脚本会将 opencode.json 写入全局配置目录，并提示你输入 API key。

准备方式（建议建一个临时目录，例如 opencode-config）：

  1. 下载脚本
  2. macOS / Linux 还需要下载 opencode.json
  3. 将需要的文件放在同一目录

Windows 脚本 ​

在 opencode-config 目录中运行：

bash
opencode-config.bat

Windows 脚本已内置 opencode.json，无需额外下载配置文件。

macOS / Linux 脚本 ​

在 opencode-config 目录中运行：

bash
sh opencode-config.sh

注：macOS / Linux 脚本需要同目录下的 opencode.json；该脚本未在 Windows 上测试，仅供 macOS / Linux 使用。