OpenCode在Windows上的安装与使用入门 | 保姆级教程
2026/7/13 17:28:22 网站建设 项目流程

AI工具更新的太快,让人应接不暇,现把OpenCode的安装与使用过程也记录下来供大家参考,它主要的好处就相当于是开源版的ClaudeCode,还能用Anthropic的模型,废话不多说,下面给操作过程:

1.安装 Node.js 环境

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

使用浏览器访问官网https://nodejs.org/

点击 "LTS" 版本进行下载(推荐长期支持版本)

下载完成后双击.msi文件,按提示完成安装,保持默认设置即可。

安装后验证Node.js是否正常,打开 PowerShell 或 CMD,输入以下命令:

node --version npm --version

如果显示版本号,说明安装成功了,如下:

Windows系统上注意事项:

  • 优先使用 PowerShell ,其次再使用 CMD
  • 如果遇到权限问题,尝试以管理员身份运行

2. 安装 OpenCode

使用管理员权限打开 PowerShell 或 CMD,运行以下命令:

npm install -g opencode-ai@latest

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

验证 OpenCode 安装

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

opencode --version

如果显示版本号,OpenCode 已经成功安装了。

3. 获取UniVibe API 密钥

由于各种限制及科学上网问题,国内用户可以使用国内的模型。

买完后可以获取baseurl、apikey、model_id这几个关键信息。

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": "厂家名称", "options": { "baseURL": "", "apiKey": "你的apikey" }, "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: 你的 API 密钥
  • models: 可用的模型列表,在这个JSON节点添加更多您需要的模型
添加更多模型

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

模型列表从厂家获取

5. 开始使用 OpenCode

现在你可以开始使用 OpenCode 了,启动 OpenCode:

在项目目录中打开 PowerShell,然后运行:

cd F:\AICode\OpenCode\PlantsVsZombies opencode

OpenCode 启动后,使用/model命令选择模型:

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

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

常用命令

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

以下是给孩子演示的一个编写游戏案例,帮他培养使用ai编程的意识。

输入了指令要求后我就去打乒乓了,回来已经搞定,自此,ai编程又多了一个选择。

附录:

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 访问网络

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询