OpenCode 安装与配置（推荐）

这篇教程使用同一套流程完成 OpenCode 安装和 TokenFlash 配置：

1. 安装 Node.js 24。
2. 使用 npm 安装 OpenCode CLI。
3. 修改 .config/opencode/opencode.json。
4. 启动 OpenCode 并切换模型。

第一步：直接安装 Node.js

本文提供 Node.js 24.18.0 安装包直链，无需进入带广告的下载页面。Windows 和 macOS 用户直接下载安装包即可。

node -v
npm -v

node -v
npm -v

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs

node -v
npm -v

备用方案：使用 NVM 安装 Node.js 24

需要同时管理多个 Node.js 版本，或者官网安装包无法正常使用时，再选择 NVM。完整步骤请查看 NVM、Node.js 22 和 npm 环境准备。

winget install CoreyButler.NVMforWindows

nvm install 24
nvm use 24

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

nvm install 24
nvm use 24
nvm alias default 24

第二步：统一安装 OpenCode CLI

完成 Node.js 安装后，在刚才打开的 PowerShell 或终端中依次执行下面的命令。可以整段复制粘贴，也可以一行一行执行：

node -v
npm -v
npm install -g opencode-ai
opencode --version

你应该看到：

• node -v 输出 v24.x.x。
• npm -v 输出 npm 版本号。
• opencode --version 输出 OpenCode 版本号。

可选：使用官方 curl 脚本

macOS、Linux 和 WSL 也可以跳过 Node.js 环境，直接执行：

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

原生 Windows 无法直接使用这条 Bash 命令，所以需要三平台统一操作时，仍然推荐 npm 方案。

第三步：创建配置文件

CLI 和桌面端共用同一个全局配置文件。配置一次后，两边都可以使用 TokenFlash 模型。

New-Item -ItemType Directory -Force "$HOME\.config\opencode"
notepad "$HOME\.config\opencode\opencode.json"

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

第四步：写入 TokenFlash 配置

打开 TokenFlash API Key 页面，创建 API Key 后点击 使用令牌。

选择 OpenCode 客户端并复制配置。请仍以本页的完整 JSON 为准，避免漏掉必要字段。

把 在这里填写你的APIKey 替换为你的 TokenFlash API Key，然后将下面内容完整粘贴到 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenflash": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenFlash",
      "options": {
        "baseURL": "https://tokenflash.cn/v1",
        "apiKey": "在这里填写你的APIKey"
      },
      "models": {
        "gpt-5.6-sol": {
          "name": "GPT-5.6-Sol"
        }
      }
    }
  },
  "model": "tokenflash/gpt-5.6-sol"
}

配置项说明

模型 ID 必须与 TokenFlash 支持的模型名称完全一致。需要添加其他模型时，在 models 中按照相同格式增加条目，并前往 模型定价 查看当前可用的模型 ID。

例如，新增一个模型：

"模型ID": {
  "name": "显示名称"
}

添加多个模型时，注意使用英文逗号分隔。JSON 最后一项后面不能保留逗号。

第五步：启动并切换模型

进入你的项目目录并启动 OpenCode：

cd /path/to/your-project
opencode

进入 OpenCode 后：

1. 输入 /models，确认能看到 TokenFlash 下配置的模型。
2. 选择需要使用的模型。
3. 输入 /init，让 OpenCode 分析项目并生成 AGENTS.md。
4. 输入一个简单任务，例如“读取项目结构并告诉我如何启动”。

桌面端安装

桌面端是可选项。它与 CLI 共用刚才创建的 opencode.json，无需重复配置模型。

建议通过 OpenCode 官方下载页面 获取最新版本。

• macOS：打开 DMG，将 OpenCode 拖入 Applications 文件夹。
• Windows：双击安装程序，并按照界面提示完成安装。
• Linux：双击 DEB 或 RPM 安装包，使用系统软件中心安装。

安装后启动桌面端并打开项目。如果模型列表没有立即更新，请完全退出桌面端后重新打开。

可选：在桌面端手动添加提供商

如果你不想编辑 JSON，也可以在桌面端的提供商设置中选择 Custom Provider。

按下表填写。Base URL 必须保留末尾的 /v1。

添加后，在提供商设置中确认 API Key 和模型，然后选择需要使用的模型。

更新 OpenCode

三个平台都使用同一条 npm 命令更新 CLI：

npm update -g opencode-ai
opencode --version

桌面端请访问 官方下载页面 获取最新安装包。

常见问题

opencode 命令不存在

关闭并重新打开终端，然后依次执行：

node -v
npm -v
npm install -g opencode-ai
opencode --version

看不到 TokenFlash 模型

依次检查：

1. 配置文件路径和文件名是否正确。
2. Windows 文件名是否被保存成 opencode.json.txt。
3. JSON 是否使用英文双引号，最后一项后面是否有多余逗号。
4. baseURL 是否为 https://tokenflash.cn/v1。
5. 修改后是否完全重启 OpenCode。

提示 API Key 无效

前往 API 密钥页面 确认 Key 可用，并检查复制时是否带入了空格。不要在 API Key 前后添加额外引号或中文符号。

官方资源

• OpenCode 官网
• OpenCode 官方文档
• OpenCode 下载页面