OpenCode Window系统安装和使用自定义模型实战

AI基础 opencode  收藏
0 / 8

为什么要用 OpenCode？

在各种 AI 插件满天飞的今天，OpenCode 凭什么出圈？

  1. 完全免费开源 ：不再被订阅费背刺，支持接入各种大模型。
  2. 终端原生 ：直接在你的 Terminal 里运行，像高级开发人员一样操作你的文件系统。
  3. 支持 LSP（语言服务协议） ：它能 “读懂” 你的项目结构，不只是简单的对话。
  4. 多种模式 ：Plan（构建模式） 自动改代码。
  5. 不用注册账号，不需要绑定信用卡，几乎没有额外限制。下载安装后就能用，而且是免费的。

适合人群：

  • 没接触过AI编程的纯小白
  • 想在 OpenCode 中接入 自建 / 代理 / 中转模型服务
  • 需要同时使用 GPT、Claude、Gemini 的开发者
  • 希望打造 多模型统一调用入口 的工程师

第一步：一键安装（保姆级）

全网都是nodejs的安装方式，实在无语，安装非常简单，没必要把人绕晕！打开网址https://opencode.ai/download 下载客户端。

image.png

双击下载的 OpenCode Desktop Installer.exe 安装。

第二步：选择模型

打开IDE编辑器后，选择模型后即可开始使用。

image.png

1. 如果你想追求 “Claude 的平替感” —— 首选 GLM-4.7

智谱这个版本是专门针对 OpenCode 这种终端 Agent 训练的。它不仅代码写得好，最重要的是它 “懂规矩”，知道什么时候该读文件，什么时候该运行 npm test，出错后的自愈能力（Self-healing）是这四个里最好的。

2. 如果你在做复杂逻辑，GLM 搞不定 —— 试试 Big Pickle

它是 OpenCode 社区最近的黑马，虽然名字搞怪，但它的 “推理（Reasoning）” 能力很强。当你发现 AI 总是改不对同一个 Bug 时，切到 Big Pickle 往往有奇效。

3. 如果你只是想找个 “高级版 Copilot” —— 用 Grok Code Fast 1

它的特点就是快。如果你在快速迭代，不希望等 AI 思考太久，Grok 能给你丝滑的体验。

小白用户阅读到止就可以正常使用了，下面内容是面向高阶用户的。

第三步 自定义自己的模型

默认配置路径：C:\Users\用户名\.config\opencode

第四步 替换为实测可用的完整配置示例（建议直接收藏）

支持 GPT / Claude / Gemini，自建或中转服务通用：

{
  "$schema": "https://opencode.ai/config.json",
  "theme": "opencode",
  "autoupdate": true,
  "tools": {
    "write": true,
    "bash": true,
    "read": true,
    "edit": true,
    "glob": true,
    "grep": true
  },
  "permission": {
    "webfetch": "allow",
    "bash": "ask",
    "edit": "ask",
    "skill": "allow"
  },
  "provider": {
    "axonhub-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AxonHub OpenAI",
      "options": {
        "baseURL": "http://address:port/v1",
        "apiKey": "{env:AXONHUB_API_KEY}"
      },
      "models": {
        "gpt-5": { "id": "gpt-5", "name": "GPT-5" },
        "gpt-5.1": { "id": "gpt-5.1", "name": "GPT-5.1" }
      }
    },
    "axonhub-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AxonHub Claude",
      "options": {
        "baseURL": "http://address:port/anthropic/v1",
        "apiKey": "{env:AXONHUB_API_KEY}"
      },
      "models": {
        "claude-sonnet-4.5": {
          "id": "claude-sonnet-4.5",
          "name": "Claude Sonnet 4.5"
        }
      }
    },
    "axonhub-gemini": {
      "npm": "@ai-sdk/google",
      "name": "AxonHub Gemini",
      "options": {
        "baseURL": "http://address:port/gemini/v1beta",
        "apiKey": "{env:AXONHUB_API_KEY}"
      },
      "models": {
        "gemini-2.5-flash": {
          "id": "gemini-2.5-flash",
          "name": "Gemini 2.5 Flash"
        }
      }
    }
  }
}

第五步 推荐好用的转发服务(需要充值)

打开https://open.metaevos.ai/，然后注册/登录获取apiKEY和baseURL。
image.png

配置示例：

{
  "$schema": "https://opencode.ai/config.json",
  "theme": "opencode",
  "autoupdate": true,
  "tools": {
    "write": true,
    "bash": true,
    "read": true,
    "edit": true,
    "glob": true,
    "grep": true
  },
  "permission": {
    "webfetch": "allow",
    "bash": "ask",
    "edit": "ask",
    "skill": "allow"
  },
  "provider": {
    "axonhub-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "中转的OpenAI",
      "options": {
        "baseURL": "https://open.metaevos.ai/v1",
        "apiKey": "sk-xxxxxxxxKurLPHF_kE9EyCywtQPU8pbWl1H4nIziwzx9809u711QsJtKZ5A"
      },
      "models": {
        "gpt-5.1": { "id": "gpt-5.1", "name": "GPT-5.1" },
        "gpt-5.2": { "id": "gpt-5.2", "name": "GPT-5.2" }
      }
    },
    "axonhub-anthropic": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "中转的Claude",
      "options": {
        "baseURL": "https://open.metaevos.ai/v1",
        "apiKey": "sk-xxxxxxxxKurLPHF_kE9EyCywtQPU8pbWl1H4nIziwzx9809u711QsJtKZ5A"
      },
      "models": {
        "claude-sonnet-4.5": {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4.5"
        }
      }
    }
    }
  }
}

每次更新配置后需要重启IDE客户端，然后在模型选项里选择刚配置的模型。

image.png