用惯了网页版 AI，总会碰到几个卡点：对话记录带不走、公司内网访问不了、想换个便宜模型还得重新登录一遍。ChatBox 这类桌面客户端的价值就在这——数据在本地，接口随便换。但第一次打开设置页，看到“API Key”“API Host”“模型”几个空框，很多人就卡住了。其实配置过程比想象中简单，五分钟能搞定。
先准备三样东西
一是你的 API Key，形如 sk-xxxxxxxx，从模型服务商后台复制，注意只显示一次，先存好。二是 API 地址，官方接口是 https://api.openai.com/v1，用第三方中转或自建服务的话，对方会给你一个自定义地址，通常也以 /v1 结尾。三是模型名称，比如 gpt-4o、deepseek-chat，别写错大小写。这三样凑齐，剩下的就是填空。
第一步：把 Key 填进去
打开 ChatBox，左下角齿轮进设置，左侧选“模型提供方”或者直接找“API”标签。模型提供方下拉里选 OpenAI API（大部分兼容接口都走这个协议）。在 API Key 输入框粘贴你的 Key。粘贴时留意首尾空格，这是最常见的失败原因之一，肉眼看不出来但请求会直接报 401。
第二步：改 API 地址
往下找“API Host”或“API 地址”，默认值一般是官方地址。如果你用的是中转服务，把这里整段替换成服务商给的那串，保留末尾的 /v1，不要多写斜杠也不要漏协议头。改完可以先点一下旁边的“检查”或“验证”按钮，多数版本会实时返回连通状态，比等出错再排查省事。
第三步：选模型
模型一栏可以手动输入，也可以点下拉从列表里挑。如果你用的服务商支持多个模型，建议先填一个确定可用的，跑通之后再回来加。有些版本支持在这里配多个模型别名，方便随时切换，比如把 gpt-4o-mini 和 deepseek-chat 都列上，日常问答走便宜的，复杂任务再切贵的。
第四步：发一条消息验证
关掉设置，新建对话，随便问一句。正常的话几秒内就有回复。如果报错，按这个顺序排查：401 是 Key 不对或已过期；404 多半是 API 地址少了 /v1 或路径写错；429 是额度用完或被限流；模型不存在则检查名称拼写。
整体就这么四步，真正容易出错的只有两个地方：API 地址的格式和 Key 的粘贴。建议第一次配置时先只填一个模型，跑通再扩充。另外把配置好的参数记在备忘录里，换电脑或重装时能省掉重新翻后台找 Key 的麻烦。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。