环境变量与配置
推荐做法
Codebyby 中继接入建议优先通过环境变量管理基础地址和 API Key。这样在域名轮换、Key 更新或多环境切换时更容易维护。
至少需要关注的配置项
不同客户端命名可能不同，但你通常需要确认两类信息：
- API 基础地址
- API Key
如果客户端还要求模型名、组织标识或额外请求头，也应一并核对。
配置时的原则
- 使用当前实例公布的中继地址，而不是上游默认地址。
- 确保 Key 与当前基础地址属于同一实例。
- 优先把配置放在用户级环境变量或受控配置文件中。
- 不要把真实 Key 提交到仓库、截图或公开日志中。
多环境时怎么区分
如果你有开发、测试、生产等多个环境，建议：
- 为不同环境使用不同配置文件或变量前缀
- 在切换环境前重新确认当前基础地址
- 保留一个轻量 smoke test 用来确认切换是否成功
发现异常时先看哪里
- 环境变量是否真的生效
- 客户端是否读取了你以为的那份配置
- 路径前缀是否遗漏
- 是否仍有旧 Key 或旧域名残留