
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-ailatest这个命令会从 npm 官方仓库下载并安装最新版本的 OpenCode。验证 OpenCode 安装安装完成后输入以下命令检查是否安装成功opencode --version如果显示版本号OpenCode 已经成功安装了。3. 获取UniVibe API 密钥由于各种限制及科学上网问题国内用户可以使用国内的模型。买完后可以获取baseurl、apikey、model_id这几个关键信息。4. 配置 OpenCodeOpenCode 使用配置文件来管理 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 opencodeOpenCode 启动后使用/model命令选择模型输入/model输入univibe进行搜索从列表中选择你配置的模型如claude-sonnet-4-5或gpt-5-high按回车确认选择模型后你就可以开始使用 OpenCode 进行 AI 辅助编程了。常用命令/model- 切换模型/help- 查看帮助/new- 新对话/exit- 退出 OpenCode以下是给孩子演示的一个编写游戏案例帮他培养使用ai编程的意识。输入了指令要求后我就去打乒乓了回来已经搞定自此ai编程又多了一个选择。附录Windows 常见问题解决安装时提示 permission denied 错误这通常是权限问题尝试以下解决方法以管理员身份运行 PowerShell或者配置 npm 使用用户目录npm config set prefix %APPDATA%\npmPowerShell 执行策略错误如果遇到执行策略限制运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser配置文件路径问题Windows 配置文件路径为C:\Users\你的用户名\.config\opencode\opencode.json如果找不到配置文件确保目录已正确创建文件名正确包括.json扩展名使用文本编辑器如记事本保存时选择 所有文件 类型OpenCode 找不到命令如果运行opencode提示找不到命令确认安装成功npm list -g opencode-ai检查 npm 全局路径是否在 PATH 中npm config get prefix重新打开 PowerShell 窗口尝试重新安装npm install -g opencode-ailatest连接 API 失败如果提示 API 连接失败检查配置文件中的 API 密钥是否正确确认 API 密钥在 UniVibe 控制台中是有效的检查网络连接是否正常确保防火墙允许 OpenCode 访问网络