Xikapi 接入文档

常见命令与报错处理 ​

这一页用于快速查找 OpenCode 常用命令和 Xikapi provider 排错方法。

常用命令 ​

目标命令
启动 TUIopencode
查看版本opencode --version
查看已连接认证opencode auth list
初始化项目上下文/init
连接 provider/connect
选择模型/models

/models 看不到 Xikapi ​

检查：

  • 是否在当前项目根目录放了 opencode.json。
  • provider id 是否和 /connect 中输入的一致。
  • JSON 是否有效。
  • models 是否写在 provider.xikapi.models 下。

鉴权失败 ​

先运行：

bash
opencode auth list

确认 xikapi 凭据存在。如果使用环境变量，确认当前终端能读取：

bash
echo $XIKAPI_API_KEY

Windows PowerShell：

powershell
$env:XIKAPI_API_KEY

404 或接口路径错误 ​

baseURL 应写成：

text
https://xikapi.com/v1

不要写完整的 /chat/completions。

工具调用异常 ​

OpenCode 自定义 OpenAI 兼容 provider 通常使用：

json
"npm": "@ai-sdk/openai-compatible"

如果模型或供应商使用 /v1/responses，需要按 OpenCode 官方说明调整 provider 包或模型配置。一般 Xikapi OpenAI 兼容接入先使用 @ai-sdk/openai-compatible。

参考链接 ​