Appearance
终端 Agent 接入 Ulnvault：环境变量怎么填，档位怎么选
结论先行：终端 Agent 的接入点只有两个——一个服务地址、一个密钥。地址填 Ulnvault 的兼容端点
https://ai.ulnit.com/v1，密钥用你的 Ulnvault Key；变量名各客户端不同（常见形如*_BASE_URL、*_API_KEY），以你所用的客户端文档为准。
配置思路：三个变量
多数终端 Agent 允许用环境变量覆盖内置配置：
bash
# 变量名以你的客户端文档为准，下面只是通用形态
export AGENT_BASE_URL="https://ai.ulnit.com/v1" # 服务地址
export AGENT_API_KEY="你的 Ulnvault Key" # 密钥
export AGENT_MODEL="anthropic/claude-sonnet-5" # 默认档位面向 Anthropic 协议的客户端常见 ANTHROPIC_BASE_URL 与 ANTHROPIC_ 开头的密钥变量，面向 OpenAI 协议的客户端常见 OPENAI_BASE_URL / OPENAI_API_KEY；是否还需要额外的开关或兼容模式，请按你的客户端文档填写，不要凭猜测试。变量写进 shell 配置或项目 .env，不要提交到仓库。
先验证端点，再配 Agent
配置前用一条 curl 确认地址与密钥可用：
bash
curl https://ai.ulnit.com/v1/chat/completions \
-H "Authorization: Bearer $AGENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"anthropic/claude-sonnet-5","messages":[{"role":"user","content":"ping"}]}'返回 200 且带 choices 字段说明端点正常；401 查密钥，404 查地址是否少了 /v1。
模型档位选择（每百万 token，采集 2026-10-08）
| Agent 角色 | 建议 model | 输入 | 输出 | 何时切过来 |
|---|---|---|---|---|
| 日常改码主力 | anthropic/claude-sonnet-5 | $2.2 | $11 | 默认档，工具调用稳定 |
| 疑难重构 | anthropic/claude-opus-5 | $5.5 | $27.5 | 连续两轮修不好再上 |
| 整仓理解（105 万上下文） | z-ai/glm-5.3 | $0.0539 | $3.729 | 只读检索与摘要 |
| 批量小改 | deepseek/deepseek-v4-flash | $0.0105 | $1.408 | 注释、格式化、改命名 |
会话成本控制
- 限制单次会话最大轮数，超限就先手工总结、再开新会话
- 长日志先裁剪再喂给 Agent，别让整段报错栈反复进入上下文
- 每轮都要重发历史，所以「越快收敛越省钱」优先于「单价更低」
- 定期看会话用量，把高频只读任务挪到低价档
档位分配思路可配合 /use-cases/coding-agent.md 一起看。
常见问题
客户端只认自家模型名怎么办？
把默认档位的 model 改成站内模型 ID；少数客户端会用固定模型名发起请求，这种情况按文档里的模型映射项填写。
配置后仍报认证失败？
先跑上面的 curl 自检：curl 也返回 401 说明密钥或地址不对；curl 正常而 Agent 报错，多半是变量名没被识别，或值里带了引号与空格。
终端 Agent 该用按量 API 还是订阅？
低频使用者按量更贴近真实消耗；高频使用者把只读与批量任务降到低价档后，按量同样可控。
切换档位会影响会话连贯性吗？
会话内换模型不会丢历史，但不同模型的输出风格有差异，建议在任务边界处切换，而不是一轮之内来回换。
价格与采集时间？
单价按 2026-10-08 实时核验；站内价 = OpenRouter 挂牌 ×1.1。