Appearance
术语解释
适用对象:第一次接触 API Key、模型与接口地址的用户。预计耗时:3 分钟。
如果第一次配置编程助手,先认识下面几个词,再按自己的工具打开 配置速查表。
| 词 | 通俗解释 | 在连接AI里怎么用 |
|---|---|---|
| API Key | 证明“这是你的请求”的密钥 | 从 主站 API 密钥创建,不能公开 |
| 分组 | 一把 Key 能使用的模型和接口范围 | 创建 Key 时选择;选错分组需创建新的 Key |
| Model ID | 模型的完整名字 | 选这把 Key 可用的 ID,不照抄截图中的演示值 |
| Base URL | 工具发请求的服务地址 | Claude Code 用根地址,其他工具按各自协议填写 |
| Provider | 工具里保存的一组服务配置 | 可由快速导入、CC Switch 或手动配置生成 |
| API 格式 | 工具发请求时使用的规则 | Claude 用 Messages,Codex 用 Responses,部分工具用 Chat Completions |
为什么地址有时带 /v1
Claude Code 的 Anthropic Messages 配置以 https://lianjieai.top 为根地址;Codex 的 Responses Provider 用 https://lianjieai.top/v1。WorkBuddy 桌面版的 url 字段则要完整写到 /v1/chat/completions。地址是由工具和所选接口决定的,不能用一条“所有工具通用的 Base URL”替代。见 配置速查表。
为什么模型必须从自己的 Key 选
分组不同,可用模型也不同。快速导入窗口会用当前 Key 读取模型目录:Codex 使用专用目录,其他工具使用普通 /v1/models 列表。选择适合目标工具的文本编程模型;Codex 模型还需支持 Responses 接口。模型 ID 多一个空格或字符,都可能出现 model not found。
常见接口名称
- Anthropic Messages:Claude Code 主要使用的接口。
- OpenAI Responses:Codex 使用的接口。
- OpenAI Chat Completions:本指南中的 DeepSeek Harness、WorkBuddy、Pi,以及 DeepSeek 分组的 OpenCode 示例所用接口。
- Streaming:回复逐段显示。是否启用以对应工具和模型支持情况为准;它不会替代正确的接口配置。
按工具选择下一步:Claude Code、Codex、DeepSeek Harness、WorkBuddy、OpenCode、Pi。
完成检查
你能指出自己 Key 的分组、模型 ID 和目标工具要求的地址;拿不准时按 准备接入信息逐项查。
