macOS / Linux OpenCode 安装指南

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

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

系统要求

系统
macOS / Linux
依赖
Node.js 16+
Node.js 安装（如果没有安装）
macOS：前往 nodejs.org/zh-cn/download 下载
Linux（Debian/Ubuntu）：curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -，然后 sudo apt-get install -y nodejs

安装步骤

1

打开终端

macOS 可用 Cmd+Space 搜索 Terminal，或使用 VS Code / JetBrains 的内置终端打开；Linux 打开你常用的终端即可。

2

安装 OpenCode

npm i -g opencode-ai
3

创建并复制 API Key

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

4

脚本快速配置（推荐）

curl -fsSL https://code.jimuxyz.com/env_deploy/opencode-deploy.sh | bash -s -- "你的Codex_API_KEY" "你的Claude_API_KEY" "你的Gemini_API_KEY"

脚本会写入 ~/.config/opencode/opencode.json 并备份旧文件。参数顺序：Codex / Claude / Gemini。

脚本失败排障：

  • 提示下载失败：检查网络/代理或稍后重试。
  • 提示 API Key 为空：确认已把 Codex / Claude / Gemini 三个 Key 都替换为真实值。
  • 写入后不生效：关闭并重新启动 OpenCode。
或者

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

手动配置

删除 ~/.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