Windows OpenCode 使用说明

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

返回热门工具 登录后创建三条产品线 Key
开始前先做这一步：先到 Key 管理 创建三条产品线 Key。文档里所有 你的Codex_API_KEY / 你的Claude_API_KEY / 你的Gemini_API_KEY 都必须替换成你自己的真实 Key，否则无法使用。

快速入口

先到「Key 管理」创建 Codex / Claude Code / Gemini 三条产品线 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

创建并复制三条产品线 Key

登录后到「Key 管理」页面分别创建 Codex / Claude Code / Gemini 三条产品线的 Key（各复制一份）。三把 Key 互不通用。

Codex 当前推荐模型：gpt-5.4；也可按需切换 gpt-5.3-codex。

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 Code / Gemini。

脚本只写入三条产品线的 provider 和 Key；进入 OpenCode 后选择 Codex/OpenAI provider 时，推荐优先使用 gpt-5.4。

脚本失败排障：

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

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

手动配置

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

Codex/OpenAI provider 推荐模型：gpt-5.4；备用可选：gpt-5.3-codex。

{
    "$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