OpenCode 接入 NoneLinear
OpenCode 是一款开源的 AI 编程 Agent，支持终端界面、桌面应用和 IDE 扩展。本文使用 CC Switch 的 OpenCode 模块，以 OpenAI Compatible 格式接入 NoneLinear API。
前置要求
1. 安装 OpenCode
macOS 和 Linux 推荐使用 OpenCode 官方安装脚本：
curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai
brew install anomalyco/tap/opencode
npm install -g opencode-ai
2. 进入 CC Switch 的 OpenCode 配置页
打开 CC Switch，切换到顶部的 OpenCode 模块，点击右上角 +，然后选择 自定义配置。
在基础信息区域填写：
| 字段 | 填写内容 |
|---|
| 供应商标识 | nonelinear |
| 供应商名称 | NoneLinear |
| 官网链接 | https://nonelinear.com/ |
nonelinear/模型ID 的形式显示。
3. 配置 NoneLinear API
继续向下填写接口信息：
| 字段 | 填写内容 |
|---|
| 接口格式 | OpenAI Compatible |
| API Key | 你的 NoneLinear API Key |
| Base URL | https://api.nonelinear.com/v1 |
setCacheKey: true 会让 OpenCode 为该供应商的请求始终设置缓存键，有利于支持提示词缓存的模型复用稳定上下文。CC Switch 会自动把 true 解析为布尔值。
API Key 属于敏感凭据，请勿在截图、聊天记录或公开仓库中泄露。本文截图中的 API Key 已隐藏。
4. 添加模型
填写 API Key 和 Base URL 后，在 模型配置 区域点击 获取模型列表。CC Switch 会调用 NoneLinear 的模型接口，并在下拉列表中显示当前可用模型。
选择需要的模型后，可以按需填写显示名称。模型 ID 必须与 NoneLinear 模型列表 中的名称保持一致，包括大小写、连字符和版本号。
如果没有自动获取到模型，也可以点击 添加模型 手动填写。需要多个模型时，逐行添加即可。
配置完成后，点击右下角 添加；回到供应商列表后，启用刚创建的 NoneLinear 配置。
5. 在 OpenCode 中验证
关闭已运行的 OpenCode 会话，重新打开终端并进入一个空目录或小型项目：
cd /path/to/your-project
opencode
nonelinear 供应商下的模型，然后发送一条简单测试消息，例如：
能够正常返回结果，说明 NoneLinear API 已接入成功。
首次在项目中使用时，还可以执行：
OpenCode 会分析项目，并在项目根目录生成 AGENTS.md，用于记录项目结构和开发规范。建议将该文件提交到 Git。
常见问题
获取模型列表失败
确认 API Key 有效，且 Base URL 完整填写为 https://api.nonelinear.com/v1。如果仍然失败，可以根据 NoneLinear 模型列表 手动添加模型。
OpenCode 中看不到 NoneLinear 或新模型
确认供应商已经保存并启用，然后完全退出当前 OpenCode 会话并重新运行 opencode。在 /models 中查找 nonelinear 供应商。
为什么简单问题也会消耗较多 Token
OpenCode 是编程 Agent，请求中还会包含系统提示词、工具定义、历史上下文以及读取到的项目文件和命令结果。初次连通性测试建议使用空目录或小目录，并优先选择性价比较高的模型。
更多配置方式可查看 OpenCode 提供商文档。