Windows OpenCode 安装指南

在 Windows 系统上安装 OpenCode，并配置为使用积木AI代码助手接口。

返回热门工具 登录后创建三条产品线 Key

系统要求

系统
Windows 10/11
依赖
Node.js 16+
Node.js 安装（如果没有安装）
前往 nodejs.org/zh-cn/download 下载。

安装步骤（Windows 终端）

1

打开 PowerShell / Windows Terminal

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行。

2

安装 OpenCode

npm i -g opencode-ai

若 PowerShell 提示“无法加载 *.ps1，因为在此系统上禁止运行脚本”，请先执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新打开终端再试。

3

创建并复制 API Key

登录后到「API Key」页面分别创建 Codex / Claude / Gemini 三条产品线的 Key（各复制一份）。

4

脚本快速配置（推荐）

powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:JIMUXYZ_CODEX_KEY='你的Codex_API_KEY'; $env:JIMUXYZ_CLAUDE_KEY='你的Claude_API_KEY'; $env:JIMUXYZ_GEMINI_KEY='你的Gemini_API_KEY'; iwr -useb https://code.jimuxyz.com/env_deploy/opencode-deploy.ps1 | iex"

脚本会写入 C:\Users\你的用户名\.config\opencode\opencode.json 并备份旧文件。参数顺序：Codex / Claude / Gemini。

脚本失败排障：

  • 提示“无法加载 *.ps1”：先执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，重启终端后再试。
  • 提示下载失败：检查网络/代理或稍后重试。
  • 提示 API Key 为空：确认已把 Codex / Claude / Gemini 三个 Key 都替换为真实值。
  • 写入后不生效：关闭并重新启动 OpenCode。
或者

跳到下方「手动配置」，按手动方式替换 JSON 内容。

手动配置

删除 C:\Users\你的用户名\.config\opencode 路径下已存在的 opencode.json（若有），然后新建 opencode.json，写入如下内容，并将各产品线 apiKey 改成自己的 Key。

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "anthropic": {
            "options": {
                "baseURL": "https://code.jimuxyz.com/p",
                "apiKey": "你的Claude_API_KEY"
            }
        },
        "openai": {
            "options": {
                "baseURL": "https://code.jimuxyz.com/p",
                "apiKey": "你的Codex_API_KEY"
            }
        },
        "google": {
            "options": {
                "baseURL": "https://code.jimuxyz.com/p",
                "apiKey": "你的Gemini_API_KEY"
            }
        }
    }
}

开始使用

1

在任意项目目录运行

# 导航到你的项目
cd your-project-folder

# 启动 OpenCode
opencode

# 切换模型（支持 anthropic / openai / google）
/model