OpenCode 安装配置，切换模型

环境
Win11

一、相关链接

Open Code 官网
https://opencode.ai/zh

Open Code 文档

下载 OpenCode
[1] OpenCode 终端
[2] OpenCode 桌面版
[3] OpenCode 扩展
[4] OpenCode 集成

github
https://github.com/anomalyco/opencode/blob/dev/README.zh.md

二、安装（CLI）

Windows (WSL)
通过 WSL 在 Windows 上运行 OpenCode 以获得最佳体验。

# 软件包管理器
npm i -g opencode-ai@latest        # 也可使用 bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows

三，使用及配置

没配环境变量DASHSCOPE_API_KEY

opencode

cmd输入opencode

如果环境变量里没有什么API Key的配置，如阿里云百炼的DASHSCOPE_API_KEY

默认使用免费模型，Big Pickle

聊天

退出

聊天输入/exit

模型切换（免费模型）

聊天输入/models

（OpenCode Zen）免费模型列表（显示名称）
Ling-3.0-Flash Free
Laguna S 2.1 Free
North Mini Code Free
Nemotron 3 Ultra Free
DeepSeek V4 Flash Free (New)
MiMo V2.5 Free
Big Pickle（当前选中）

选择DeepSeek V4 Flash Free (New)

选择推理强度

切换模型完成

配了环境变量DASHSCOPE_API_KEY

优先从auth.json取API Key，其次是从环境变量里取

opencode

cmd输入opencode

如果环境变量里有API Key的配置，如阿里云百炼的DASHSCOPE_API_KEY

默认使用模型：QwQ Plus

聊天报错

原因：区域不匹配

OpenCode 默认调用的是国际版端点

我的 API Key 是国内版

你好
Incorrect API key provided. For details, see: https://www.alibabacloud.com/help/en/model-studio/error-code#apikey-error
▣  Build · QwQ Plus
Build·QwQ PlusAlibaba
C:\Users\admin    tab agents    ctrl+p commands

切换到常用模型，也报错

模型切换（免费模型）

聊天输入/models

可以切换到免费模型

聊天

退出

聊天输入/exit

四、连接到其他提供商模型

连接到国内的阿里云百炼的模型

/connect设置

聊天输入/connect

/connect 是凭据管理

选择Alibaba (China)

粘贴API key（Ctral+C）

选择模型

厂商显示的是Alibaba (China)

聊天

国内国外厂商区别

opencode providers

这个命令也可以连接到提供商（的模型）

C:\Users\admin>opencode providers --help
opencode providers

manage AI providers and credentials

Commands:
  opencode providers list               list providers and credentials                 [aliases: ls]
  opencode providers login [url]        log in to a provider
  opencode providers logout [provider]  log out from a configured provider

Options:
  -h, --help        show help                                                              [boolean]
  -v, --version     show version number                                                    [boolean]
      --print-logs  print logs to stderr                                                   [boolean]
      --log-level   log level                   [string] [choices: "DEBUG", "INFO", "WARN", "ERROR"]
      --pure        run without external plugins                                           [boolean]
 

C:\Users\admin>opencode providers list

┌  Credentials ~\.local\share\opencode\auth.json
│
└  0 credentials

┌  Environment
│
●  Alibaba DASHSCOPE_API_KEY
│
●  Alibaba (China) DASHSCOPE_API_KEY
│
└  2 environment variables

C:\Users\admin> opencode providers login

┌  Add credential
│
◆  Select provider

│  Search: _
│  ● OpenCode Zen (recommended)
│  ○ OpenAI
│  ○ GitHub Copilot
│  ○ Google
│  ○ Anthropic
│  ○ OpenRouter
│  ○ Vercel AI Gateway
│  ...
│  ↑/↓ to select • Enter: confirm • Type: to search
└

选择
│  ○ Alibaba (China)

◇  Select provider
│  Alibaba (China)
│
◆  Enter your API key
│  _
└

◇  Enter your API key
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
└  Done

其他更多提供商

C:\Users\admin> opencode providers login

┌  Add credential
│
◆  Select provider

│  Search: _
│  ● OpenCode Zen (recommended)
│  ○ OpenAI
│  ○ GitHub Copilot
│  ○ Google
│  ○ Anthropic
│  ○ OpenRouter
│  ○ Vercel AI Gateway
│  ...
│  ↑/↓ to select • Enter: confirm • Type: to search
└
│  ○ 302.AI
│  ○ AI-ROUTER
│  ○ AIHubMix
│  ○ AKI.IO
│  ● Abacus
│  ○ Alibaba
│  ○ Alibaba (China)
│  ○ Alibaba Coding Plan
│  ○ Alibaba Coding Plan (China)
│  ○ Alibaba Token Plan
│  ● Alibaba Token Plan (China)
│  ○ Amazon Bedrock
│  ○ Ambient
│  ○ AnyAPI
│  ○ Atomic Chat
│  ○ Auriko
│  ● Azure
│  ○ Azure Cognitive Services
│  ○ Bailing
│  ○ Baseten
│  ○ Berget.AI
│  ○ Blue Claw
│  ● Cerebras
│  ○ Charm Hyper
│  ○ Chutes
│  ○ Clarifai
│  ○ Claudinio
│  ○ ClinePass
│  ● CloudFerro Sherlock
│  ○ Cloudflare AI Gateway
│  ○ Cloudflare Workers AI
│  ○ Cohere
│  ○ Cortecs
│  ○ CrofAI
│  ● CrossModel
│  ○ D.Run (China)
│  ○ DInference
│  ○ DaoXE
│  ○ Databricks
│  ○ Deep Infra
│  ● DeepSeek
│  ○ DigitalOcean
│  ○ EBCloud
│  ○ EmpirioLabs AI
│  ○ FastRouter
│  ○ Fireworks AI
│  ● FreeModel
│  ○ Friendl
│  ○ FrogBot
│  ○ GMI Cloud
│  ○ GitHub Models
│  ○ GitLab Duo
│  ● GreenPT
│  ○ Groq│  ○ HPC-AI
│  ○ Helicone
│  ○ Hetzner
│  ○ Hugging Face
│  ● IO.NET
│  ○ Inception
│  ○ Inceptron
│  ○ InferX
│  ○ Inference
│  ○ Jiekou.AI
│  ● KUAE Cloud Coding Plan
│  ○ Kenari
│  ○ Kilo Gateway
│  ○ Kimi For Coding
│  ○ LLM Gateway
│  ○ LLMTR
│  ● LMStudio
│  ○ Lilac
│  ○ Llama
│  ○ LongCat
│  ○ LucidQuery
│  ○ Lynkr
│  ● Meganova
│  ○ Merge Gateway
│  ○ Meta
│  ○ MiniMax (minimax.io)
│  ○ MiniMax (minimaxi.com)
│  ○ MiniMax Token Plan (minimax.io)
│  ● MiniMax Token Plan (minimaxi.com)
│  ○ Mistral
│  ○ Mixlayer
│  ○ Moark
│  ○ Modal
│  ○ Model Oracle AI
│  ● ModelScope
│  ○ Moonshot AI
│  ○ Moonshot AI (China)
│  ○ Morph
│  ○ NEAR AI Cloud
│  ○ NanoGPT
│  ● Nebius Token Factory
│  ○ Neon
│  ○ Neuralwatt
│  ○ Nova
│  ○ NovitaAI
│  ○ Nvidia
│  ● OVHcloud AI Endpoints
│  ○ Ofox
│  ○ Ollama Cloud
│  ○ OpenCode Go
│  ○ OrcaRouter
│  ○ Perplexity
│  ● Perplexity Agent
│  ○ Pioneer
│  ○ Poe
│  ○ Poolside
│  ○ Privatemode AI
│  ○ QiHang
│  ● Qiniu
│  ○ Regolo AI
│  ○ Requesty
│  ○ SAP AI Core
│  ○ STACKIT
│  ○ Sakana AI
│  ● Sarvam AI
│  ○ Scaleway
│  ○ SiliconFlow
│  ○ SiliconFlow (China)
│  ○ Snowflake Cortex
│  ○ StepFun (China)
│  ● StepFun (Global)
│  ○ StepFun Step Plan (China)
│  ○ StepFun Step Plan (Global)
│  ○ Subconscious
│  ○ Synthetic
│  ○ Tencent Coding Plan (China)
│  ● Tencent Token Plan
│  ○ Tencent TokenHub
│  ○ The Grid AI
│  ○ Thinking Machines
│  ○ Tinfoil
│  ○ Together AI
│  ● TrustedRouter
│  ○ Umans AI
│  ○ Umans AI Coding Plan
│  ○ UnoRouter
│  ○ Upstage
│  ○ Venice AI
│  ● Vertex
│  ○ Vertex (Anthropic)
│  ○ Vivgrid
│  ○ Vultr
│  ○ Wafer
│  ○ Weights & Biases
│  ● Xiaomi
│  ○ Xiaomi Token Plan (China)
│  ○ Xiaomi Token Plan (Europe)
│  ○ Xiaomi Token Plan (Singapore)
│  ○ Xpersona
│  ○ Z.AI
│  ● Z.AI Coding Plan
│  ○ Zeldoc
│  ○ ZenMux
│  ○ Zenifra
│  ○ Zhipu AI
│  ○ Zhipu AI Coding Plan
│  ● abliteration.ai
│  ○ ai&
│  ○ evroc
│  ○ iFlow
│  ○ routing.run
│  ○ submodel
│  ● v0
│  ○ xAI
│  ○ Other

选择
│  ○ Alibaba (China)

◇  Select provider
│  Alibaba (China)
│
◆  Enter your API key
│  _
└

◇  Enter your API key
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
└  Done

C:\Users\admin> opencode providers logout

┌  Remove credential
│
◆  Select provider

│  Search: _
│  ● Alibaba (China) (api)
│  ↑/↓ to select • Enter: confirm • Type: to search
└

C:\Users\admin> opencode providers logout

┌  Remove credential
│
◇  Select provider
│  Alibaba (China) (api)
│
└  Logout successful

opencode.jsonc

C:\Users\admin\.config\opencode\opencode.jsonc

通过 provider 字段，可以自定义提供商的 baseURL、模型列表等，也支持添加 OpenAI 兼容的自定义提供商：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",   // OpenAI 兼容接口用这个适配器
      "name": "My Provider",                 // UI 显示名
      "options": {
        "baseURL": "https://api.myprovider.com/v1",
        "apiKey": "{env:MY_API_KEY}"         // API Key 放这里
      },
      "models": {
        "my-model-name": {
          "name": "My Model",
          "limit": { "context": 200000, "output": 65536 }
        }
      }
    }
  }
}

npm 字段：接口走 /v1/chat/completions 用 @ai-sdk/openai-compatible；走 /v1/responses 则用 @ai-sdk/openai

示例

{
  "$schema": "https://opencode.ai/config.json",
  "model": "alibaba-cn/qwen3.7-flash",
  "provider": {
    "bailian-cn": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Bailian (China)",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "{env:DASHSCOPE_API_KEY}"
      },
      "models": {
        "qwen3.7-flash": {
          "name": "Qwen3.7 Flash"
        },
        "qwen3.7-plus": {
          "name": "Qwen3.7 Plus"
        },
        "qwen3.7-max": {
          "name": "Qwen3.7 Max"
        }
      }
    }
  }
}

加入limit的

{
  "$schema": "https://opencode.ai/config.json",
  "model": "alibaba-cn/qwen3.7-flash",
  "provider": {
    "bailian-cn": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Bailian (China)",
      "options": {
        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "{env:DASHSCOPE_API_KEY}"
      },
      "models": {
        "qwen3.7-flash": {
          "name": "Qwen3.7 Flash",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "qwen3.7-plus": {
          "name": "Qwen3.7 Plus",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "qwen3.7-max": {
          "name": "Qwen3.7 Max",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        }
      }
    }
  }
}

limit的上下文长度和最大输出长度可以在以下文件中查找

C:\Users\admin\.cache\opencode\models.json

阿里云百炼帮助文档

qwen3.7-flash

阿里云百炼模型广场

qwen3.7-flash

这俩文档可能有细微差别，如qwen-3.7-max的最大输出长度

切换模型

Bailian (China)会在切换模型时显示，

bailian-cn会在模型文件中显示

C:\Users\admin\.local\state\opencode\model.json

/connect 里会有显示

五、指定默认模型

启动时指定
opencode -m alibaba-cn/wen3.7-flash
opencode -m alibaba-cn/qwen3.7-plus

opencode -m opencode/deepseek-v4-flash-free

在配置文件中指定，加入model
C:\Users\admin\.config\opencode\opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/deepseek-v4-flash-free"
}

六、配置文件

opencode.jsonc

可以配置提供商的模型，可以配置默认模型

C:\Users\admin\.config\opencode\opencode.jsonc

C:\Users\admin\.config\opencode\opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "alibaba-cn/qwen3.6-flash"
}

默认没有model配置，这个是配置默认启动模型的

auth.json

存储提供商的API Key

优先从auth.json取API Key，其次是从环境变量里取

C:\Users\admin\.local\share\opencode\auth.json

{
  "alibaba-cn": {
    "type": "api",
    "key": "sk-59b0************************fea4"
  }
}

model.json

使用的模型，收藏的模型

C:\Users\admin\.local\state\opencode\model.json

{
    "recent": [
        {
            "providerID": "opencode",
            "modelID": "deepseek-v4-flash-free"
        },
        {
            "providerID": "opencode",
            "modelID": "big-pickle"
        },
        {
            "providerID": "alibaba-cn",
            "modelID": "qwen3.6-flash"
        },
        {
            "providerID": "alibaba",
            "modelID": "qwen3.6-flash"
        }
    ],
    "favorite": [],
    "variant": {
        "opencode/big-pickle": "default",
        "alibaba/qwq-plus": "default",
        "alibaba-cn/qwen3.6-flash": "default",
        "opencode/deepseek-v4-flash-free": "default"
    }
}

recent：最近使用的模型列表，按时间倒序。
favorite：收藏的模型，目前是空的
variant：模型变体配置，推理强度

操作改的哪个文件

/connect 输入 API Key    auth.json
opencode providers login    auth.json
手动配置 provider 和模型    opencode.jsonc
设置默认模型    opencode.jsonc
切换模型 / 收藏模型    model.json

models.json

C:\Users\admin\.cache\opencode\models.json

这个文件有各提供商各模型的信息，如模型id，模型name，limit的上下文长度和最大输出长度

七、卸载及清理数据

卸载

1. OpenCode 自带卸载命令（更彻底）
opencode uninstall

2. 标准 npm 卸载（只卸包）
npm uninstall -g opencode-ai
只移除 npm 全局包，配置文件和数据保留。

只清理数据

opencode debug --help

C:\Users\admin>opencode debug paths
home       C:\Users\admin
data       C:\Users\admin\.local\share\opencode
bin        C:\Users\admin\.cache\opencode\bin
log        C:\Users\admin\.local\share\opencode\log
repos      C:\Users\admin\.local\share\opencode\repos
cache      C:\Users\admin\.cache\opencode
config     C:\Users\admin\.config\opencode
state      C:\Users\admin\.local\state\opencode
tmp        C:\Users\admin\AppData\Local\Temp\opencode

# 配置、数据、状态、缓存全删
rmdir /s /q C:\Users\admin\.config\opencode
rmdir /s /q C:\Users\admin\.local\share\opencode
rmdir /s /q C:\Users\admin\.local\state\opencode
rmdir /s /q C:\Users\admin\.cache\opencode

八、其他命令

OpenCode CLI 选项和命令

CLI

opencode帮助

opencode -h

列出提供商的所有模型

opencode models alibaba-cn

九、opencode桌面版

安装文件：OpenCode Desktop Installer.exe

安装巨快，一下没注意就安装完了

opencode桌面版应该是跟opencode cli共享配置。

首页

切换模型（免费模型）

聊天