嘀嘀嘀 AI 文档

切换主题

OpenCode ​

项目介绍

OpenCode 是一个开源的 AI 编码代理，可在终端、桌面端或 IDE 中使用。它支持通过自定义 provider 接入 OpenAI 兼容接口，适合在本地项目里进行代码阅读、修改、重构和自动化任务。

本站接入地址 ​

类型地址
API 地址https://dddai.dev/v1

配置建议

OpenCode 接入 嘀嘀嘀 AI 时，建议新增一个自定义 provider，例如 dddai。baseURL 填写 https://dddai.dev/v1，模型名称使用控制台中实际可用的模型 ID。

接入前准备 ​

  • API 地址：https://dddai.dev/v1
  • API Key
  • 可用模型名称
  • Node.js、Bun、pnpm、Homebrew 或系统包管理器中的任意一种安装方式

如果你还没有 API Key，请先到 API 密钥 页面创建。

安装 OpenCode ​

macOS / Linux ​

官方推荐使用安装脚本：

bash
curl -fsSL https://opencode.ai/install | bash

也可以使用 Node.js 包管理器安装：

bash
npm install -g opencode-ai

Homebrew 用户可使用：

bash
brew install anomalyco/tap/opencode

Arch Linux 用户可使用：

bash
sudo pacman -S opencode

或安装 AUR 最新版本：

bash
paru -S opencode-bin

Windows ​

Windows 推荐使用 WSL，以获得更好的终端兼容性。进入 WSL 后可按 macOS / Linux 的安装方式执行：

bash
curl -fsSL https://opencode.ai/install | bash

也可以在 Windows 原生环境中使用 npm、Chocolatey 或 Scoop：

powershell
npm install -g opencode-ai
powershell
choco install opencode
powershell
scoop install opencode

安装完成后检查版本：

bash
opencode --version

使用 嘀嘀嘀 AI 作为模型提供商 ​

OpenCode 的自定义 provider 需要两部分配置：

  1. 把 API Key 保存到 OpenCode 的认证信息中，或通过环境变量提供
  2. 在 opencode.json 中声明 provider、接口地址和可选模型

配置文件可以放在全局路径：

text
~/.config/opencode/opencode.json

也可以放在项目根目录：

text
opencode.json

配置优先级

项目根目录的 opencode.json 会覆盖全局配置中冲突的字段，适合为不同项目指定不同默认模型。

方式一：使用认证命令保存 API Key ​

在终端执行：

bash
opencode auth login

按提示选择或搜索 Other，provider ID 填写：

text
dddai

然后粘贴你的 嘀嘀嘀 AI API Key。完成后可以检查认证信息：

bash
opencode auth list

接着创建或编辑 ~/.config/opencode/opencode.json：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "dddai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "嘀嘀嘀 AI",
      "options": {
        "baseURL": "https://dddai.dev/v1"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash"
        }
      }
    }
  },
  "model": "dddai/gpt-5.4",
  "small_model": "dddai/gemini-2.5-flash"
}

替换模型名称

上面的 gpt-5.4、gemini-2.5-flash 只是示例。请把它们替换为你账号当前实际可用的模型名称。

方式二：使用环境变量提供 API Key ​

如果不想通过 opencode auth login 保存密钥，也可以用环境变量：

bash
export DDDAI_API_KEY="sk-your-api-key"

然后在 opencode.json 中写入：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "dddai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "嘀嘀嘀 AI",
      "options": {
        "baseURL": "https://dddai.dev/v1",
        "apiKey": "{env:DDDAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash"
        }
      }
    }
  },
  "model": "dddai/gpt-5.4",
  "small_model": "dddai/gemini-2.5-flash"
}

如果希望环境变量长期生效，可以把 export DDDAI_API_KEY=... 写入 ~/.zshrc、~/.bashrc 或当前 shell 对应的启动文件。

关键配置说明 ​

配置项说明
provider.dddai自定义 provider ID，需要和 opencode auth login 中填写的 ID 一致
npmOpenAI 兼容接口使用 @ai-sdk/openai-compatible
options.baseURL填写 https://dddai.dev/v1，不用再追加 /chat/completions
options.apiKey可选；如果已用 opencode auth login 保存密钥，可以不写
models模型 ID 到显示名称的映射，模型 ID 必须和本站实际模型名称一致
model默认主模型，格式为 provider/model-id
small_model轻量任务模型，常用于标题生成等低成本任务

验证配置 ​

1. 刷新并查看模型 ​

bash
opencode models --refresh

你应该能看到类似下面的模型格式：

text
dddai/gpt-5.4
dddai/gemini-2.5-flash

也可以启动 OpenCode 后输入：

text
/models

在模型列表中选择 dddai/... 模型。

2. 在项目中启动 OpenCode ​

进入你的项目目录：

bash
cd /path/to/your/project
opencode

第一次进入项目时，建议先执行：

text
/init

OpenCode 会分析当前项目，并生成或更新项目说明文件，帮助后续对话理解项目结构。

3. 运行一次简单任务 ​

可以先让 OpenCode 做只读任务：

text
Explain this project structure and list the main entry points.

确认模型能正常响应后，再进行代码修改、测试执行等更高权限操作。

权限与安全建议 ​

OpenCode 默认可以让模型使用编辑和命令执行能力。第一次接入新模型时，建议开启确认模式：

json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

如果你已经有上面的 provider 配置，只需要把 permission 合并到同一个 opencode.json 顶层即可。

常见问题 ​

1. /models 看不到 嘀嘀嘀 AI 模型 ​

优先检查：

  • provider 里的 ID 是否是 dddai
  • opencode auth login 中填写的 provider ID 是否也是 dddai
  • models 里是否已经添加模型 ID
  • 是否执行过 opencode models --refresh

2. 请求报 401 或认证失败 ​

通常是 API Key 没有被 OpenCode 读取到。请检查：

  • API Key 是否来自当前 嘀嘀嘀 AI 账号
  • 如果使用环境变量，启动 opencode 的同一个终端里是否能读取 DDDAI_API_KEY
  • 如果使用认证命令，opencode auth list 中是否能看到 dddai

3. 请求报 404 或模型不存在 ​

大多是模型名称不匹配。请到 个人设置 或控制台模型列表确认模型 ID，再原样填入 models 和 model 字段。

4. baseURL 应该填 /v1 还是 /v1/chat/completions ​

OpenCode 的 options.baseURL 填 https://dddai.dev/v1 即可。@ai-sdk/openai-compatible 会根据调用类型拼接对应端点。

5. Windows 原生终端体验不稳定 ​

建议改用 WSL。进入 WSL 后重新安装 OpenCode，并在 WSL 内配置 ~/.config/opencode/opencode.json 与 API Key。

相关页面 ​

© 2026 嘀嘀嘀 AI，保留所有权利。