跳到主要内容

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)
npmAI SDK 包;/v1/chat/completions 请使用 @ai-sdk/openai-compatible
name提供商的显示名称
options.baseURLAPI 端点,必须包含末尾的 /v1
options.apiKeyAPI 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 切换模型。