OpenCode

OpenCode 是一个开源 AI coding agent，可以在终端 TUI、桌面应用或 IDE 扩展中使用。它适合终端用户、远程服务器、WSL 和需要可配置 provider 的开发工作流。

对于使用 Xikapi 的用户，OpenCode 可以通过自定义 OpenAI 兼容 provider 接入 https://xikapi.com/v1，并在 /models 中选择 Xikapi 模型。

OpenCode 有什么用

场景	OpenCode 可以做什么
终端 Agent	在 TUI 里读代码、改代码、运行命令
自定义 provider	使用 OpenAI 兼容 API、代理或本地模型
多模型切换	通过 /models 在不同模型间切换
远程开发	在 SSH、WSL、服务器环境中使用
项目级配置	用 opencode.json 固定项目模型和 provider
排错	用 opencode auth list 和配置文件定位 provider 问题

OpenCode 更适合喜欢终端界面、希望 provider 配置透明、并且需要在项目中保留配置文件的用户。

文档入口

• 安装指南
• 配置 Xikapi 模型
• 使用教程
• 常见命令与报错处理

推荐接入顺序

1. 完成 安装指南。
2. 按 配置 Xikapi 模型 写入 opencode.json。
3. 用 /connect 保存 Xikapi API Key。
4. 用 /models 选择模型。
5. 先执行只读任务，再授权修改。

参考链接

• OpenCode 文档
• OpenCode Providers
• OpenCode Config

新手验收清单

开始前

• 从 Xikapi 控制台复制 API Key 和一个当前可用的模型 ID；不要猜测或照抄其他工具页的模型名。
• 先完成 1 分钟首次调用，确认 Key、模型和网络本身可用。
• 打开本工具的“配置 Xikapi 模型”页面。字段名称可能不同，但必须以该页规定的 provider、地址和模型格式为准。

配置完成的标志

1. 使用纯文本测试消息或最小任务得到正常回复。
2. 没有 401、403、404 或 model not found。
3. 再单独打开流式输出、图片、工具调用、知识库或自动化等高级能力；不要一次全开。

密钥、版本与求助

• API Key 只放在工具的私密设置、环境变量或服务端 Secret 中；不要导出、提交或截图完整 Key。
• 工具版本不同会改变字段名称和界面位置。遇到差异时，优先查看本页末尾的官方文档，再参考本工具的报错页。
• 求助时提供工具版本、模型 ID、状态码和已打码错误文本；完整 Key、Token、Cookie 和私人资料不应发送。