更多接入

OpenCode

OpenCode 是一个开源终端 AI 编程助手,适合想用轻量 CLI 接入飞行API 的用户。

什么是 OpenCode

SECTION-1

如果你想要一个更轻、更自由的终端助手,OpenCode 会是一个很顺手的选择。它的特点通常包括:

  • 开源、轻量,适合自己折腾和扩展。
  • 命令行操作简单,适合本地仓库分析与问答。
  • 支持接入自定义 API 地址和 API Key。
  • 适合把飞行API当成统一模型入口来使用。

你需要准备

SECTION-2
  • 已安装 Node.js 18+。如果还没装,先看 安装 Node.js
  • 一个可用的飞行API Key,可参考 注册并创建 Key
  • 建议提前确认账户余额和模型分组已经准备好。

安装 OpenCode

SECTION-3

先全局安装 OpenCode CLI:

npm install -g opencode-cli

安装完成后,建议先执行一次版本检查或帮助命令,确认命令已经进入 PATH。

Windows 配置

SECTION-4

在 Windows 上,建议打开 PowerShell 后设置环境变量:

setx OPENCODE_API_KEY "你的飞行API Key"
setx OPENCODE_BASE_URL "https://ai.flyapi.top/v1"

设置完成后,关闭终端并重新打开一个新的 PowerShell 窗口再继续。

macOS 配置

SECTION-5

macOS 默认常见是 zsh,可把配置写进 ~/.zshrc

export OPENCODE_API_KEY="你的飞行API Key"
export OPENCODE_BASE_URL="https://ai.flyapi.top/v1"

然后执行:

source ~/.zshrc

Linux 配置

SECTION-6

Linux 常见是写进 ~/.bashrc

export OPENCODE_API_KEY="你的飞行API Key"
export OPENCODE_BASE_URL="https://ai.flyapi.top/v1"

然后执行:

source ~/.bashrc

启动与验证

SECTION-7

配置完成后,直接在项目目录启动:

opencode

如果启动后能正常列出模型或进入交互界面,说明接入已经生效。

常见问题

SECTION-8
  • 如果提示找不到 opencode 命令,先重开终端,再确认 npm 全局包路径正常。
  • 如果配置了 Key 还是连不上,先检查 Base URL 是否写成了 https://ai.flyapi.top/v1
  • 如果调用失败,也别忘了检查令牌分组和账户余额。

排查没结果时,可以回到 常见问题 页继续看。