OpenCode 接入 Agnes AI 模型完整配置教程CLI 端 桌面端macOS 版本 · Agnes AI · OpenCode v1.15Part 1 CLI 端安装与配置STEP 1 安装 OpenCode CLI打开终端Command 空格 → 输入「终端」→ 回车。在终端中运行安装命令等待完成期间不要关闭终端curl -fsSL https://opencode.ai/install | bash安装成功后终端会显示opencode installed successfully刷新环境变量让 opencode 命令生效source ~/.zshrc验证安装opencode --version 如提示网络错误请先开启代理后重新运行安装命令。STEP 2 创建 opencode.json 配置文件用文本编辑器打开或新建以下路径的配置文件~/.config/opencode/opencode.json按下图写入完整配置内容 ▲ opencode.json 配置第 1–9 行schema、默认模型、agnes provider 开头▲ opencode.json 配置第 10–16 行baseURL、apiKey、models 配置▲ opencode.json 配置第 17–26 行agnes provider 收尾▲ opencode.json 配置第 27–35 行DeepSeek provider 示例可选保留 “model” 字段设置默认模型格式为 provider_id/model_id这里默认使用 agnes-2.0-flash。STEP 3 设置 Agnes API Key 环境变量配置文件中 apiKey 使用 {env:AGNES_API_KEY} 读取环境变量需要先在终端设置▲ 在终端中设置环境变量将 xxxxx 替换为真实的 Agnes API Key如需永久生效将以下内容写入 ~/.zshrcecho ‘export AGNES_API_KEY“你的真实Key”’ ~/.zshrcsource ~/.zshrc⚠️ API Key 是敏感信息不要直接硬写进 opencode.json务必通过环境变量方式传入。STEP 4 启动 OpenCode选择 Agnes 模型在终端中进入任意项目目录后启动 OpenCodeopencode进入 TUI 界面后输入 /models 命令打开模型选择器可以看到 Agnes 出现在列表▲ 模型列表中出现 Agnes → agnes-2.0-flash选中即可选择后直接开始对话▲ CLI 端使用 Agnes-2.0-Flash 正常对话接入成功✅ CLI 端接入完成Agnes-2.0-Flash 正常响应配置全部正确。Part 2 桌面端安装与配置STEP 1 下载并安装 OpenCode Desktop打开下载页https://opencode.ai/download根据你的 Mac 芯片选择版本Apple SiliconM1 / M2 / M3 / M4→ 下载 macOS (Apple Silicon)Intel 芯片 → 下载 macOS (Intel)查看芯片左上角 苹果图标 → 关于本机 → 查看「芯片」一栏。下载完成后双击 .dmg将 OpenCode 拖入 Applications 即可完成安装与安装微信方式相同。 如 macOS 提示「无法验证开发者」系统设置 → 隐私与安全性 → 仍要打开再重新启动。STEP 2 打开设置进入自定义提供商启动 OpenCode Desktop点击左下角齿轮图标进入设置选择「提供商」▲ 设置 → 提供商页面点击「自定义提供商」右侧的「 连接」STEP 3 填写 Agnes 自定义提供商信息在弹出的自定义提供商表单中按以下信息逐项填写▲ 填写提供商 IDagnes、显示名称Agnes、基础 URL、API 密钥▲ 填写模型 IDagnes-2.0-flash和显示名称Agnes 2.0 Flash▲ 模型填写完成后点击「提交」按钮保存配置⚠️ 基础 URL 只填 https://apihub.agnes-ai.com/v1不要加 /chat/completions否则会报错。STEP 4 验证接入开始对话提交后回到主界面底部模型切换为 Agnes 2.0 Flash发送一条消息验证▲ 桌面端使用 Agnes-2.0-Flash 正常对话接入成功✅ 桌面端接入完成Agnes 正常回复所有配置均正确。核心参数速查 配置完成OpenCode 现在可以通过 Agnes AI 执行代码任务了