OpenCode
准备 API
在配置之前,请确保你已准备好以下信息:
API Key
你创建的 API Key 字符串。
Base URL
地址:https://api.jalapeno-cloud.ai/v1
重要提示:必须包含末尾的 /v1
模型名称
从模型市场复制完整的模型名称,例如 DeepSeek-V4-Pro
安装 OpenCode
通过 OpenCode 官方渠道下载并安装。OpenCode
Linux / macOS / WSL2
curl -fsSL https://opencode.ai/install | bash
或者通过 npm 安装:
npm install -g opencode-ai
Windows
OpenCode 推荐使用 WSL2 以获得最佳体验。请参照上方的 Linux 命令,在 WSL2 内完成安装。
如需在原生 Windows 上安装,可通过 Chocolatey 或 Scoop:
choco install opencode
# or
scoop install opencode
或者通过 npm 安装:
npm install -g opencode-ai
连接 OpenCode
OpenCode 通过在 ~/.config/opencode/opencode.json 中定义的自定义提供商转发请求。
编辑配置文件
创建或编辑 ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"model": "jalapeno/GLM-5.1",
"provider": {
"jalapeno": {
"npm": "@ai-sdk/openai-compatible",
"name": "Jalapeno Cloud",
"options": {
"baseURL": "https://api.jalapeno-cloud.ai/v1",
"apiKey": "{env:JALAPENO_API_KEY}"
},
"models": {
"GLM-5.1": {
"name": "GLM-5.1"
},
"DeepSeek-V4-Pro": {
"name": "DeepSeek-V4-Pro"
},
"MiniMax-M2.7": {
"name": "MiniMax-M2.7"
}
}
}
}
}
字段说明
| 字段 | 说明 |
|---|---|
model | 默认模型,格式为 provider/model(例如 jalapeno/GLM-5.1) |
npm | AI SDK 包;/v1/chat/completions 请使用 @ai-sdk/openai-compatible |
name | 提供商的显示名称 |
options.baseURL | API 端点,必须包含末尾的 /v1 |
options.apiKey | API key;使用 {env:VAR_NAME} 从环境变量读取 |
models | 模型市场中可用的模型 ID |
注意: 顶层 model 字段为必填项。models 下的模型 ID 必须与模型市场中的名称一致。
设置 API Key
运行 OpenCode 前请导出你的 API key:
export JALAPENO_API_KEY="your-api-key"
将导出命令添加到你的 shell 配置文件(例如 ~/.bashrc 或 ~/.zshrc),以便在会话之间持久生效。
或者,运行 opencode providers login,选择 Other,输入提供商 ID jalapeno,然后粘贴你的 API key。
切换模型
修改顶层 model 字段,或在命令行中通过 -m 指定:
"model": "jalapeno/DeepSeek-V4-Pro"
验证连接
导出 JALAPENO_API_KEY 后,运行:
opencode run -m jalapeno/GLM-5.1 "Reply with exactly one word: hello"
运行成功会返回 pong。
使用模型
在项目目录下启动交互式 TUI:
opencode
在 TUI 中使用 /models 切换模型。