OpenCode

OpenCode 是 Claude Code 的开源替代品,跨平台终端 AI agent,支持任何 OpenAI 兼容 endpoint。

1. 安装

# Mac / Linux
curl -fsSL https://opencode.ai/install | bash

# Windows PowerShell
iwr -useb https://opencode.ai/install.ps1 | iex

验证:

opencode --version

2. 配置 Provider

OpenCode 配置位置:

系统	路径
macOS / Linux	`~/.config/opencode/opencode.json`
Windows	`%APPDATA%\opencode\opencode.json`

文件不存在就创建。完整内容:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "miloapi-claude": {
      "name": "Miloapi (Claude)",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://www.miloapi.com/v1",
        "apiKey": "sk-你的claude-max-key"
      },
      "models": {
        "claude-opus-4-7": { "name": "Claude Opus 4.7" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    },
    "miloapi-openai": {
      "name": "Miloapi (GPT)",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://www.miloapi.com/v1",
        "apiKey": "sk-你的gpt-key"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.4": { "name": "GPT-5.4" }
      }
    }
  }
}

可以同时配多个 provider,OpenCode 启动时让你选。

3. 启动

opencode

第一次进入会让你选 provider 和 model,选 miloapi-claude → claude-opus-4-7 就跑起来了。

4. 故障排查

现象	处理
`provider not found`	JSON 格式错或者 `$schema` 字段错误,贴去 jsonlint.com 验证
`model not supported`	模型名拼错,见模型映射表
切换 provider 后不生效	重启 opencode

5. 关键差异 vs Claude Code

维度	OpenCode	Claude Code
协议	通用,可接任何 OpenAI / Anthropic 兼容	只走 Anthropic 协议
多 provider	✅ 内置	❌(需 CC-Switch)
团队功能	限基础	较完善
推荐场景	想同时混用多模型	主要跑 Claude