连接工具：地址后面要不要加 /v1

明确 Base URL、API Key、模型名与协议的关系，先用一个最小请求检验连接。

每个工具至少要填三项

设置	应填什么
Base URL／API 地址	User Client 显示的本地入口，按工具协议补路径
API Key／Token	User Client 创建的本地 Key
Model／模型	这把 Key 的模型目录中实际可用的模型名

地址和 Key 要来自同一个运行中的 Client。不要把网页管理地址、平台 API Key、上游官方 Key 混在一起。

如何拼地址

假设 Client 显示根入口是 http://127.0.0.1:18000：

OpenAI 兼容 SDK 的 Base URL 一般填 http://127.0.0.1:18000/v1，SDK 再补 chat/completions 或 responses。
Claude Code 的 ANTHROPIC_BASE_URL 一般填根入口，客户端会调用 /v1/messages。
直接 HTTP 请求需要填写完整端点，例如 http://127.0.0.1:18000/v1/responses。

不要出现 /v1/v1，也不要把 /v1/responses 当作 SDK 的 Base URL，除非该工具明确要求完整请求地址。你的实际端口可能不同，以界面为准。

本地入口地址可在“本地 Key”页面顶部查看和复制。

优先使用现成配置

“查看配置”用于核对和复制配置；桌面版“导入本机 Agent”可以预览目标文件、备份并应用受支持的配置；CC Switch 入口需要电脑已经安装 CC Switch。

如果工具同时支持多个提供商，选择与请求格式匹配的 OpenAI 兼容或 Anthropic 兼容提供商。即使平台可以转换协议，工具本身仍需要读懂对应的响应。

最小 HTTP 测试

下面的模型和 Key 都是占位符。将模型替换为当前 Key 目录里的可用模型，将地址换成自己的入口：

curl http://127.0.0.1:18000/v1/responses \
  -H "Authorization: Bearer YOUR_LOCAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_AVAILABLE_MODEL","input":"只回复 OK","stream":false}'

Windows PowerShell 中可以使用 curl.exe；Shell 的续行写法随环境不同，不能直接把 Bash 反斜杠续行照搬到所有 Shell。没有命令行经验时，直接在已配置好的工具里发短请求即可。

判断成功

拿到正确响应后，在“使用记录”找到对应请求。如果是编码 Agent，还要测试实际工具调用；能聊天不意味着项目路径、Shell 与权限已经都正确。

分别继续看 Codex、Claude Code 或其他 Agent。