logologo
售前咨询
快手万擎(Vanchin)
开始使用
产品介绍
模型介绍
控制台介绍
产品计费
API说明
常见问题
相关协议
文档中心
开始使用OpenCode 接入指南

OpenCode 接入指南


前置准备

进入快手万擎官网,获取快手万擎的 API Key

进入快手万擎控制台的「系统管理」,点击「API KEY 管理」,创建并复制你的 API Key

地址:https://console.streamlake.com/console/wanqing/api-key

安装OpenCode

步骤 1:OpenCode官网复制指令

打开OpenCode.ai官网,找到对应你操作系统和使用习惯的安装方式,以下以macOS系统下使用curl 安装为例。

⚠️ 安装前需要确定系统处于管理员模式下。


步骤 2:在终端安装OpenCode

将安装命令 curl -fsSL https://opencode.ai/install | bash 粘贴至“终端(Terminal)”中,并按回车执行安装。

安装时间受网络环境影响,预计需要3-5分钟,如果需要加速安装可以调整网络环境。


步骤 3:安装完成

安装完成后在终端中输入opencode看到界面,即可完成安装。


配置步骤

步骤 1:创建配置目录和文件

打开终端,执行以下命令:

# 创建配置目录(如果不存在)
mkdir -p ~/.config/opencode


# 创建并编辑配置文件
vim ~/.config/opencode/opencode.json


小白提示:如果你不熟悉 vim,可以用其他文本编辑器打开这个文件,比如 VS Code:

code ~/.config/opencode/opencode.json


步骤 2:填入配置内容,并修改API Key

将以下内容复制到 opencode.json 文件中:

{
"$schema": "https://opencode.ai/config.json",
"provider": {
"kuaishou": {
"npm": "@ai-sdk/openai-compatible",
"name": "快手万擎",
"options": {
"baseURL": "https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints",
"apiKey": "你的API_KEY"
},
"models": {
"kat-coder-air-v1": {
"name": "KAT-Coder-Air-V1",
"limit": {
"context": 128000,
"output": 128000
}
}
}
}
}
}

重要:记得要把配置里的 "你的API_KEY" 替换成你在步骤 1 中获取的真实 API Key!models改为实际需要的模型。

baseURL的选择:

计费方式    

API Base URL

按量计费

https://wanqing.streamlakeapi.com/api/gateway/v1/endpoints

已订阅 Coding Plan

https://wanqing.streamlakeapi.com/api/gateway/coding/v1


步骤 3:保存配置文件

如果用 vim:按 ESC,然后输入 :wq 回车保存退出

如果用 VS Code:直接 Cmd + S 保存


步骤 4:启动 OpenCode 并选择模型

# 进入你的项目目录
cd /path/to/your/project


# 启动 OpenCode
opencode


启动后,输入 /models 命令切换到快手万擎模型:

然后在弹出的列表中选择 KAT-Coder-Air-V1 模型即可!


验证配置是否成功

配置完成后,你可以在 OpenCode 中随便问一个问题,比如:

“你是哪个模型”

如果能正常回复,说明配置成功了!🎉


常见问题

1. 提示 API Key 无效

  • 检查 API Key 是否正确复制
  • 确认 API Key 在万擎控制台中是有效的
  • 是否存在欠费状态

2. 提示连接失败

  • 检查 baseURL 是否正确
  • 确认网络连接正常

3. 配置不生效

  • 确认配置文件路径是 ~/.config/opencode/opencode.json
  • 检查 JSON 格式是否正确(可以用 JSON 验证工具 检查)
  • 完全退出并重新启动 OpenCode

4.安装OpenCode无法启动

确认是否添加:export PATH=/Users/Yourname/.opencode/bin:$PATH

(yourname改成系统的用户名)

同时需要将路径永久添加到你的 .zshrc 文件中(这是 macOS 默认 Shell 的配置文件)。

请按以下步骤操作:

将命令写入配置文件:在终端输入并运行下面这行命令:

echo 'export PATH="/Users/haoshengchao/.opencode/bin:$PATH"' >> ~/.zshrc

刷新配置(立即生效):运行以下命令让更改立刻在当前窗口生效:

source ~/.zshrc

验证是否成功

现在可以输入 「opencode」 试试了。即使你重启电脑,这个命令依然会有效。


加入交流群

安装中如果遇到其他问题欢迎扫码加入快手万擎用户交流群,和大家共同探讨OpenCode的使用经验和各种新鲜有趣又实用的玩法。


上一篇:🦞OpenClaw 接入指南下一篇:KAT-Coder开发工具接入指南
该篇文档内容是否对您有帮助?
有帮助没帮助