Claude Code
将 Claude Code（claude CLI）接到 Trinity：使用 xh-... API Key，模型 ID 取自 模型广场。
获取 API Key
- 在 控制台 · API 密钥 创建 Key（
xh-...）。 - 管理与轮换见 管理 API 密钥。
快速配置
bash
npx -y trinity-config@latest --type claude -k xh-你的key --model claude-sonnet-4-6写入 ~/.claude/settings.json。Anthropic Base URL（不含 /v1）：
text
https://api.trinitydesk.ai完成后运行：
bash
claude手动配置
编辑 ~/.claude/settings.json，在 env 中设置：
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "xh-你的key",
"ANTHROPIC_API_KEY": "xh-你的key",
"ANTHROPIC_BASE_URL": "https://api.trinitydesk.ai",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6"
}
}ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL 可选。模型 ID 须来自 模型广场。
配置后运行：
bash
claude故障排查
| 问题 | 排查 |
|---|---|
| 401 Unauthorized | 确认 API Key 以 xh- 开头且未过期 |
| 403 model_not_allowed | 在控制台确认 Key 有该模型的调用权限 |
| 连接超时 | 确认 Base URL 为 https://api.trinitydesk.ai（不带 /v1） |
| 模型未找到 | 在 模型广场 核对模型 ID |
WARNING
不要将 API Key 提交到 Git 仓库。使用环境变量或配置文件管理 Key，定期轮换。