应用场景
Trinity 文档站按三条轨组织（对标 OpenRouter 顶栏）：
| 顶栏 | 适合什么问题 |
|---|---|
| 文档 | 第一次接 API、密钥、多模态、流式与排错 |
| API | 端点、字段表、复制 curl |
| 应用场景（本轨） | 在各类 客户端 / Agent 工具 里配置 Trinity 的 Base URL、Key 与模型 ID |
如何选分类
| 分类 | 典型场景 | 工具示例 |
|---|---|---|
| 编程 IDE / CLI | 写代码、仓库内 Agent、终端补全 | Cursor、CodeBuddy IDE/CLI、Claude Code、Codex CLI |
| 智能体工作台 | 桌面 Agent、办公自动化、本地任务、MCP/Skills | WorkBuddy |
两类产品往往都用 OpenAI 兼容 chat/completions，但 Trinity 文档按使用场景分栏，避免把「非编程 Agent」塞进「编程工具」。
编程 IDE / CLI
| 工具 | 指南 |
|---|---|
| Cursor | IDE：Override OpenAI Base URL + API Key |
| CodeBuddy | 编程向 IDE/CLI：models.json |
| Claude Code | 终端 Agent |
| CC Switch | Claude Code / Codex 等供应商可视化切换 |
| Codex CLI | config.toml |
对标 OpenRouter · Coding agents（OR 侧栏以编程类为主）。
智能体工作台
| 工具 | 指南 |
|---|---|
| WorkBuddy | 桌面 Agent · ~/.workbuddy/models.json |
MCP、Skills、本地执行等属产品能力，见 WorkBuddy 官方文档；本轨只写 Trinity 模型接入。
通用前置
1. 获取 API Key
- 在 控制台 · API 密钥 创建 Key。
- 创建 Key（
xh-...）→ 管理 API 密钥。
2. Base URL 与完整路径
bash
export TRINITY_API_KEY="xh-你的密钥"
export TRINITY_BASE_URL="https://api.trinitydesk.ai/v1"- Cursor / Claude Code / Codex：多数只需
TRINITY_BASE_URL（含/v1）。 - CodeBuddy / WorkBuddy：
models.json里url须写{TRINITY_BASE_URL}/chat/completions（完整路径）。
3. 模型 ID
从 模型广场 复制 模型 ID。
4. 验收
在工具内完成一次短对话或任务；失败见 错误与调试。