#客户端接入 · 总览与选型

按「你想做什么」选择客户端。开始配置前先确认三件套：Base URL、API Key、模型名。需要安装本地命令行工具时，先看本地环境准备。

#不知道选哪个？先看这里

#先确认教程是否适合你

每个客户端页都按同一套结构整理：适用协议、前置准备、字段对照、配置步骤、验证方式和常见问题。你只需要先确认客户端使用哪种协议，再照着对应页面填写 Base URL、API Key 和模型名。

如果客户端页面里的字段名和你当前版本略有差异，按含义对应即可：Host、Endpoint、API Base、Base URL 通常是同一类字段；Token、Secret Key、API Key 通常都是填写 sk-...。

#每篇教程怎么读

客户端页面都按同一个模板写，避免用户在不同工具之间来回猜字段。

#通用填写规则

#桌面对话客户端

适合非程序员和日常聊天用户，配置难度最低。

#AI 编码工具

适合开发者。编码工具一般需要本地有 Git、Node/Python 等项目工具，且协议选择更重要。

#智能体工具

适合想搭建个人助理、连接 IM 渠道、让模型调用工具和自动化任务的用户。这类工具通常不只是“聊天客户端”，还会运行本地 Gateway、保存配置文件，并要求你理解模型 provider、渠道和权限边界。

#浏览器插件 / 开发框架 / 移动端

适合网页翻译、知识库、应用编排和移动端使用。

#配置后怎么验证

每个客户端配置后都按这个顺序检查：

1. 发送“你好，用一句话介绍你自己”。
2. 到控制台调用日志确认有请求。
3. 看日志里的路径是否符合协议，例如 /v1/chat/completions、/v1/responses、/v1/messages。
4. 如果客户端失败但在线调试台成功，说明 Key 和模型大概率没问题，重点查客户端 Base URL 和协议。

#常见选择错误

下一步：三件套与第一个请求 或 协议选择指南。