OpenCode Windows 安装指南

限制是真多
368 阅读4分钟

前置要求

  • Windows 10 或更高版本
  • Node.js 环境（版本 18 或更高）
  • 有效的 UniVibe API 密钥

注册UniVibe API 密钥 点击注册 注册即可获得 6000积分

安装步骤

1. 安装 Node.js 环境

OpenCode 需要 Node.js 环境才能运行。

方法一：官网下载（推荐）

  1. 打开浏览器访问 https://nodejs.org/
  2. 点击 "LTS" 版本进行下载（推荐长期支持版本）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

验证 Node.js 安装

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

Windows 注意事项：

  • 建议使用 PowerShell 而不是 CMD
  • 如果遇到权限问题，尝试以管理员身份运行
  • 某些杀毒软件可能会误报，需要添加白名单

2. 安装 OpenCode

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 OpenCode
npm install -g opencode-ai@latest

这个命令会从 npm 官方仓库下载并安装最新版本的 OpenCode。

验证 OpenCode 安装

安装完成后，输入以下命令检查是否安装成功：

opencode --version

如果显示版本号，恭喜你！OpenCode 已经成功安装了。

提示：

  • 建议使用 PowerShell 而不是 CMD，功能更强大
  • 如果遇到权限问题，以管理员身份运行 PowerShell

3. 获取 API 密钥

登录 UniVibe 控制台，在 API密钥 页面创建一个新的密钥。

4. 配置 OpenCode

OpenCode 使用配置文件来管理 API 连接。我们需要创建并编辑配置文件。

创建配置目录

在 PowerShell 中运行以下命令创建配置目录（如果不存在）：

# 创建配置目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE.config\opencode"

编辑配置文件

使用记事本或你喜欢的文本编辑器打开配置文件：

# 使用记事本打开配置文件
notepad "$env:USERPROFILE.config\opencode\opencode.json"

配置内容

将以下内容粘贴到配置文件中：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "univibe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UniVibe",
      "options": {
        "baseURL": "https://api.univibe.cc/openai/v1",
        "apiKey": "你的API密钥"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {},
        "claude-opus-4-5-20251101": {},
        "claude-haiku-4-5-20251001": {},
        "gpt-5.2": {},
        "gpt-5.2-codex": {},
        "gpt-5.1-codex-max": {},
        "gemini-3-pro-preview": {},
        "gemini-3-flash-preview": {},
        "gemini-2.5-pro": {},
        "gemini-2.5-flash": {}
      }
    }
  }
}

重要：  将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

配置说明

  • apiKey: 你的 UniVibe API 密钥
  • models: 可用的模型列表，在这个JSON节点添加更多您需要的模型

添加更多模型

你可以在 models JSON节点中中添加更多可用的模型。以下是完整的模型列表：

模型列表

5. 开始使用 OpenCode

现在你可以开始使用 OpenCode 了！

启动 OpenCode

在项目目录中打开 PowerShell，然后运行：

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 OpenCode
opencode

选择模型

OpenCode 启动后，使用 /model 命令选择模型：

  1. 输入 /model
  2. 输入 univibe 进行搜索
  3. 从列表中选择你配置的模型（如 claude-sonnet-4-5 或 gpt-5-high）
  4. 按回车确认

选择模型

开始编程

选择模型后，你就可以开始使用 OpenCode 进行 AI 辅助编程了！

开始使用

常用命令

  • /model - 切换模型
  • /help - 查看帮助
  • /new - 新对话
  • /exit - 退出 OpenCode

Windows 常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

  • 以管理员身份运行 PowerShell
  • 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

配置文件路径问题

Windows 配置文件路径为：C:\Users\你的用户名.config\opencode\opencode.json

如果找不到配置文件，确保：

  • 目录已正确创建
  • 文件名正确（包括 .json 扩展名）
  • 使用文本编辑器（如记事本）保存时选择 "所有文件" 类型

OpenCode 找不到命令

如果运行 opencode 提示找不到命令：

  1. 确认安装成功：npm list -g opencode-ai
  2. 检查 npm 全局路径是否在 PATH 中：npm config get prefix
  3. 重新打开 PowerShell 窗口
  4. 尝试重新安装：npm install -g opencode-ai@latest

连接 API 失败

如果提示 API 连接失败：

  1. 检查配置文件中的 API 密钥是否正确
  2. 确认 API 密钥在 UniVibe 控制台中是有效的
  3. 检查网络连接是否正常
  4. 确保防火墙允许 OpenCode 访问网络
avatar
文章
阅读
粉丝