OpenCode 设置

配置 OpenCode CLI 使用 AIDESK API。

OpenCode 是一个基于 Go 语言的开源命令行编程工具，提供直观的终端用户界面（TUI），支持多种 LLM 提供商。通过集成 AIDESK API，即可通过统一接口、一个密钥访问所有模型。

前置条件

  • 一个 AIDESK 账户和 API Key
  • 现代终端模拟器（推荐 WezTerm、Alacritty、iTerm2 或 Windows Terminal）
前往创建 API Key

安装

安装脚本（推荐）：

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

或使用 Homebrew：

brew install anomalyco/tap/opencode

验证安装：

opencode --version

配置

在配置目录中创建 opencode.json 即可完成配置。

  • Windows：%userprofile%\.config\opencode\opencode.json
  • macOS / Linux：~/.config/opencode/opencode.json

确保配置目录存在，然后创建配置文件。以下提供两种模型配置示例：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aidesk": {
      "npm": "@ai-sdk/anthropic",
      "name": "AIDESK",
      "options": {
        "baseURL": "https://api.aideskapp.com/v1",
        "apiKey": "sk-aidesk-YOUR_KEY"
      },
      "models": {
        "claude-opus-4-7": {
          "name": "Claude 4 Opus"
        },
        "claude-sonnet-4-6": {
          "name": "Claude 4.6 Sonnet"
        },
        "claude-haiku-4-5-20251001": {
          "name": "Claude 4.5 Haiku"
        }
      }
    }
  }
}

将 sk-aidesk-YOUR_KEY 替换为您实际的 API 密钥。可在同一个 provider 中混合添加不同厂商的模型。

也可以使用 opencode auth login 命令通过交互式向导完成初始配置，再手动编辑生成的配置文件。

验证配置

保存配置文件后，重启终端，导航到工作目录并启动 OpenCode：

cd your-working-directory
opencode

在聊天界面中输入命令查看模型列表：

/models

您应该能看到 AIDESK 及其模型。选择一个即可开始使用！使用 /models 命令随时切换模型。

注意事项

  • 在专用项目文件夹中运行 OpenCode，避免在系统目录或含凭证的目录中运行
  • 配置文件使用 JSON 格式，对符号敏感，建议使用在线 JSON 验证器检查
  • 完全支持中文输入和输出

常见问题

  • 重启 OpenCode
  • 检查 opencode.json 的 JSON 语法是否正确
  • 验证配置文件路径是否正确
  • 401：API 密钥未设置或无效
  • 403：权限不足或密钥已过期
  • 检查配置文件中的 apiKey 是否为有效的 AIDESK API 密钥
  • Mac/Linux：运行 which opencode 检查是否在 PATH 中，若未找到重新安装
  • Windows：确认 Node.js 正确安装，尝试 npm i -g opencode-ai@latest 重新安装