Open Code 接入教程
下载 OpenCode，并通过 OpenAI 兼容 Provider 接入 JiaPi
适合什么场景
Open Code 适合喜欢终端开发、希望用开源编码智能体处理项目任务的用户。它可以用于代码解释、文件修改、测试运行、报错排查和开发计划拆解。
终端开发
在项目目录里启动 OpenCode，连续处理代码任务。
自定义 Provider
通过 OpenAI Compatible 接入 JiaPi Base URL 和模型。
低风险验证
先让它只读项目，再逐步进入真实修改。
服务器场景
CLI 配置更适合 WSL、Linux、远程终端和容器。
一、准备 JiaPi 参数
Provider
OpenAI Compatible、自定义 OpenAI 或类似选项。
Base URL
https://ai-api.jiapi.com
API Key
JiaPi 控制台创建的真实密钥。
Model
以 JiaPi 当前可用模型为准，示例使用 gpt-5.4。
二、下载和安装 OpenCode
三、按系统选择配置方式
桌面用户优先在设置页填写 Provider、Base URL、API Key 和 Model。
CLI 用户可以先在 PowerShell 临时设置密钥：
$env:JIAPI_API_KEY="your_api_key_here"
opencode如果项目在 WSL 中运行，请在 WSL 内按 Linux 方式重新配置。
桌面用户优先在设置页填写 Provider、Base URL、API Key 和 Model。
CLI 用户可以在 zsh/bash 中临时设置密钥：
export JIAPI_API_KEY="your_api_key_here"
opencode全局配置通常放在 ~/.config/opencode/opencode.json。
推荐用环境变量加 opencode.json，便于服务器、容器和远程终端复用。
export JIAPI_API_KEY="your_api_key_here"
opencode全局配置通常在 ~/.config/opencode/opencode.json，项目配置可以放在项目根目录 opencode.json。
桌面用户先走设置页
如果只是本机桌面使用，先用设置页添加 JiaPi Provider。只有在服务器、WSL 或纯终端中使用时，再重点看 CLI 配置文件。
四、添加 JiaPi Provider
Settings、Provider、Models 或类似菜单。Add Provider、Custom Provider 或 OpenAI Compatible。JiaPi。https://ai-api.jiapi.com。gpt-5.4，然后保存。
找不到 OpenAI Compatible？
可以尝试选择 OpenAI，再查看是否允许修改 Base URL。只要能自定义 Base URL，通常就可以接入 JiaPi。
五、CLI 配置文件示例
如果使用 OpenCode CLI / TUI，可以在项目根目录创建 opencode.json，或者在全局配置中添加 JiaPi provider。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"jiapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "JiaPi",
"options": {
"baseURL": "https://ai-api.jiapi.com",
"apiKey": "{env:JIAPI_API_KEY}"
},
"models": {
"gpt-5.4": {
"name": "gpt-5.4"
}
}
}
},
"model": "jiapi/gpt-5.4"
}项目配置
放在项目根目录 opencode.json，只影响当前项目。
全局配置
放在 ~/.config/opencode/opencode.json，适合所有项目共用。
密钥不要直接写进 JSON
示例使用 {env:JIAPI_API_KEY} 从环境变量读取密钥，避免把 API Key 提交到项目仓库。
六、验证是否可用
配置完成后，重启 OpenCode，并输入一个简单任务：
请阅读当前项目，只总结目录结构，不要修改任何文件。
认证通过
没有出现 API Key 认证失败提示。
模型可用
没有出现模型不存在或模型不可用提示。
网络正常
没有明显连接失败或超时错误。
能读项目
能正常收到模型返回的项目分析内容。
七、推荐的第一次任务
请解释这个项目的主要目录和入口文件。请找出 package.json 里的启动命令，并告诉我本地应该怎么运行。请审查当前改动，只列出可能的问题，不要修改文件。