OpenCode
为终端打造的开源 AI 编程代理，客户端/服务端架构，不绑定单一模型厂商，通过 Models.dev 支持 75+ 家模型供应商，也可自定义任意 OpenAI 兼容的接入点。
安装方式
原生安装脚本（macOS / Linux）
无需预先安装 Node.js，脚本会自带独立运行环境。
curl -fsSL https://opencode.ai/install | bash
通过 npm 安装
适用于已安装 Node.js 的环境，全局安装 CLI。
npm install -g opencode-ai
也可使用 bun install -g opencode-ai、pnpm install -g opencode-ai、yarn global add opencode-ai。
Homebrew（macOS / Linux）
brew install sst/tap/opencode
Windows
可使用 Scoop 或 Chocolatey 安装。
scoop install opencode
choco install opencode
安装完成后运行 opencode --version 验证，执行 opencode 进入交互式终端界面。
接入 ai.kedang.net
OpenCode 通过配置文件中的 provider 字段接入模型服务商，而非环境变量。将 ai.kedang.net 作为自定义 OpenAI 兼容服务商接入，需要使用 @ai-sdk/openai-compatible 适配器。
步骤 1：下载并放置配置文件
下载 opencode.json 模板，保存到以下位置之一：
全局配置
~/.config/opencode/opencode.json
项目级配置
项目根目录下的 opencode.json
步骤 2：编辑配置文件
模板内容如下，将 <模型 ID> 替换为 ai.kedang.net 模型市场中的实际模型 ID（如 kimi-k3），<模型显示名称> 替换为任意易读名称，可按需添加多个模型：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"kedang": {
"npm": "@ai-sdk/openai-compatible",
"name": "Kedang",
"options": {
"baseURL": "https://ai.kedang.net/v1",
"apiKey": "{env:KEDANG_API_KEY}"
},
"models": {
"<模型 ID>": { "name": "<模型显示名称>" }
}
}
}
}
配置中的 {env:KEDANG_API_KEY} 会读取同名环境变量，避免把密钥明文写进配置文件；也可以直接把 apiKey 的值替换为你的密钥字符串。
步骤 3：设置 API Key 环境变量
macOS / Linux
export KEDANG_API_KEY="<你的 API Key>"
写入 ~/.zshrc 或 ~/.bashrc 末尾并 source 可永久生效。
Windows（PowerShell）
$env:KEDANG_API_KEY="<你的 API Key>"
需要永久生效可在「系统属性」→「环境变量」中新建同名变量。
步骤 4：重启 OpenCode 使配置生效
修改 opencode.json 后需要完全退出并重新启动 OpenCode 才会生效，运行中的会话不会自动热加载配置。
开始使用
opencode
进入当前目录，启动交互式终端界面
/models
在交互界面中打开模型选择器，切换到已接入的模型
/connect
交互式添加内置服务商的 API Key（存储于 ~/.local/share/opencode/auth.json）
opencode --version
查看当前安装版本
故障排除
提示找不到 opencode 命令
确认安装脚本或包管理器的 bin 目录已加入 PATH，重新打开一个终端窗口再试。
模型选择器里看不到 ai.kedang.net 的模型
检查 opencode.json 路径是否正确（全局或项目根目录），并确认已完全重启 OpenCode。
请求报错 "Route not found" 或 404
确认 baseURL 末尾包含 /v1，且 models 中的模型 ID 与 ai.kedang.net 后台一致，可先用 curl 直接测试该接口排除密钥或地址问题。