首页> 都市> KingFlow AI OpenCode 2 接入教程

KingFlow AI OpenCode 2 接入教程

著

本文标签：

KingFlow AI OpenCode 2 接入教程配置 OpenAI 兼容服务商模型选择项目配置和安全验证 OpenCode 2 是可在终端、桌面端和网页端使用的开源编程代理。本文使用 OpenCode 2 的新版配置格式，将 KingFlow AI 注册为 OpenAI 兼容服务商，并说明安装、环境变量、opencode.jsonc、模型选择、项

来源：KingFlow AI 主角: 更新: 2026-10-27 15:29:27

在线阅读

【扫一扫】手机随心读

读书简介

KingFlow AI OpenCode 2 接入教程

配置 OpenAI 兼容服务商模型选择项目配置和安全验证

OpenCode 2 是可在终端、桌面端和网页端使用的开源编程**。本文使用 OpenCode 2 的新版配置格式，将 KingFlow AI 注册为 OpenAI 兼容服务商，并说明安装、环境变量、opencode.jsonc、模型选择、项目级配置、只读联调和故障排查。完成后，可以在项目目录中调用 KingFlow 已授权的模型处理代码分析和开发任务。

内容核验日期 2026-10-27

接入架构

OpenCode 在项目目录中读取代码和配置，通过自定义 OpenAI 兼容服务商向 KingFlow AI 发送请求。

环节	职责	注意事项
开发者终端	启动 OpenCode 并选择模型	在具体项目目录中运行
OpenCode 2	读取配置调用工具并组织上下文	服务商和模型使用 provider model 标识
KingFlow AI	校验密钥统计用量并按模型 ID 路由	提供 OpenAI 兼容接口
项目仓库	提供代码文件和版本状态	执行写操作前必须确认范围

开始前的准备

在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
复制一个适合代码任务的完整模型 ID。模型名称和大小写应与控制台保持一致。
准备一个测试仓库，并在开始前提交或备份现有改动。首次联调只让**读取和分析。
确认准备安装的是 OpenCode 2。本教程使用 providers 和 settings 字段，不适用于旧版 provider 配置。

安装 OpenCode 2

环境	安装方式	说明
**cOS 和 Linux	curl 安装脚本或 npm	终端原生运行
Windows	优先在 WSL 中安装	在 /mnt/c 或 /mnt/d 访问 Windows 项目
跨平台	独立 CLI 二进制	从官方发布页选择正确架构

curl -fsSL https://opencode.ai/v2/install | *ash
# 或使用 Node.js
npm install -g @opencode/cli

opencode --version

wsl --install
# 重启后进入 WSL，再运行
curl -fsSL https://opencode.ai/v2/install | *ash
cd /mnt/c/Users/<用户名>/<项目目录>
opencode --version

先验证 KingFlow 接口

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<KingFlow控制台中的完整模型ID>",
    "messages": [{"role": "user", "content": "只回复：连接成功"}],
    "stream": false
  }'

设置 API Key

export KINGFLOW_API_KEY="sk-你的密钥"
test -n "$KINGFLOW_API_KEY" && echo "环境变量已设置"

$env:KINGFLOW_API_KEY = "sk-你的密钥"
if ($env:KINGFLOW_API_KEY) { "环境变量已设置" }

创建 OpenCode 2 配置

{
  "$sche**": "https://opencode.ai/config.json",
  "model": "kingflow/<完整模型ID>",
  "providers": {
    "kingflow": {
      "name": "KingFlow AI",
      "env": ["KINGFLOW_API_KEY"],
      "package": "@opencode/ai/providers/openai-compati*le",
      "settings": {
        "*ase**L": "https://api.**nju**shen.com/v1"
      },
      "models": {
        "<完整模型ID>": {
          "name": "KingFlow Coding Model"
        }
      }
    }
  }
}

字段	填写内容	作用
providers.kingflow	自定义服务商 ID	模型引用以 kingflow 开头
env	KINGFLOW_API_KEY	从 OpenCode 进程环境读取凭据
package	openai-compati*le	调用 chat completions 兼容接口
settings.ase*L	https://api.njushen.com/v1	填写 /v1 根地址
models	完整模型 ID	键名决定可选择的模型 ID
model	kingflow 完整模型 ID	设置新会话的默认模型

OpenCode 配置流程 — 图二环境变量、**ONC、服务商、模型选择、终端测试和监控构成配置流程。AI 生成示意图。

选择配置位置

位置	路径	适用范围
全局配置	~/.config/opencode/opencode.jsonc	所有项目共享的服务商和默认项
项目配置	项目根目录/opencode.jsonc	仅当前项目使用优先级更高
自定义路径	OPENCODE_CONFIG 环境变量	临时测试或多套配置

启动并选择模型

先运行最小 curl 请求，确认 KingFlow 密钥、模型 ID 和通道本身可用。
在启动 OpenCode 的同一个终端中设置 KINGFLOW_API_KEY。环境变量未设置时，配置中的凭据会变成空值。
在全局配置目录或项目根目录创建 opencode.jsonc，粘贴新版配置。
*** <完整模型ID> 占位符替换为 KingFlow 控制台中的同一个真实模型 ID。
在项目目录运行 opencode，输入 /models，并从列表中选择 kingflow 下的目标模型。
先执行只读提示词验证模型能看到项目结构，再逐步允许搜索、测试和文件修改。

opencode run --model kingflow/<完整模型ID>   "只读分析当前项目的目录结构和主要入口，不要修改任何文件。"

完成联调验证

模型列表显示 kingflow 服务商和配置中的模型，选择时没有 Model un**aila*le 错误。
只读分析能够返回当前项目的真实目录和入口，而不是泛化回答。
运行前后比较 git status，确认首次联调没有产生未预期的文件修改。
执行一个小型测试或静态检查，确认工具调用与终端输出可以正常返回。
查看 KingFlow 控制台调用记录，确认请求使用当前密钥并计入预期通道。

管理全局和项目配置

需求	配置位置	管理原则
个人通用服务商	放在全局配置	避免每个项目重复定义
项目固定模型	在项目配置设置 model	团队成员仍需各自提供密钥
公开仓库	只提交无密钥的 **ONC	使用 env 或 file 引用凭据
实验配置	通过 OPENCODE_CONFIG 指定	不影响日常默认配置

保护密钥和代码仓库

不要把真实 API Key 写入 opencode.jsonc。使用 env 字段、{env:KINGFLOW_API_KEY} 或受控密钥文件，并确保密钥文件不进入 Git。
在有未提交改动的仓库中运行**前，先查看 git status。高风险任务应在独立分支或可恢复副本中执行。
首次使用新模型时从只读分析开始。确认工具调用格式稳定后，再允许修改文件、安装依赖或运行迁移。
为不同设备和成员创建独立密钥，并设置合理额度和有效期。发现异常请求时可以单独撤销。
如果通过 WSL 对外启动 OpenCode 服务，使用密码保护并限制**范围。不要无保护地暴露到公网。

完成检查清单

OpenCode 2 已安装，opencode --version 能正常输出。
KingFlow 最小 curl 请求已经成功。
KINGFLOW_API_KEY 只存在于受控环境或密钥文件中。
opencode.jsonc 使用 providers 和 settings 新版字段。
*ase**L 为 https://api.**nju**shen.com/v1，没有重复路径。
默认模型引用和 models 键名使用相同的完整模型 ID。
只读分析、模型选择、工具调用和 git status 检查均已通过。

常见故障排查

现象	常见原因	处理方法
配置字段不识别	混用了 OpenCode 1 的 provider 语法	改用 OpenCode 2 的 providers 和 settings
模型列表没有 KingFlow	配置位置错误或 **ONC 解析失败	确认文件名路径括号和逗号
Model un*ailale	模型键不存在被禁用或服务商不可用	核对 provider model 和 models 键名
401 未授权	环境变量为空密钥错误或已停用	在同一进程环境重设密钥并重启
404 模型不存在	模型 ID 错误或分组不支持	从 KingFlow 控制台复制完整模型 ID
404 接口不存在	ase*L 写成完整端点或重复 /v1	改回 https://api.njushen.com/v1
工具调用失败	模型不支持工具或兼容性不足	换用已验证的代码模型并做小任务测试
503 暂时不可用	通道繁忙或暂无可用账号	稍后有限重试或切换已授权模型
改动范围过大	提示词边界不清或仓库未隔离	停止任务回滚工作树并拆分请求

《KingFlow AI OpenCode 2 接入教程》资讯列表：

KingFlow AI OpenCode 2 接入教程

相关小说

为您推荐

小说标签