Codex config.toml 怎么配 Shana：作用域、Provider 与自检顺序

config.toml 适合保存 Codex 的可审查配置，但它不是把密钥随手放进项目仓库的理由。配置字段会随 Codex 版本变化，本文按官方配置参考中的作用域和字段语义说明核对顺序；最终以你当前版本的官方文档和本地帮助输出为准。

先分清用户级与项目级

项目级配置只服务当前工作目录，适合团队明确审核过的非敏感默认值；用户级配置适合个人客户端偏好。无论选择哪一级，都不要把真实 API Key 写入 Git、共享压缩包、截图或项目配置模板。团队项目可以提交不含密钥的示例文件，真实值由本机环境变量、系统凭据或客户端私有配置提供。

Shana 接入时核对三类值

1. Provider 或服务入口的名称只用于本地识别，名称可以自定义，但不要把它误当成模型名。
2. Base URL 填写 https://shana.baby/v1。如果当前客户端字段名称不同，按它的官方说明映射到服务地址，不要把首页地址当接口地址。
3. 协议选择 Responses；不要在 Base URL 后重复追加 /v1、/responses 或 /chat/completions。

最小自检顺序

1. 运行 codex --version，记录版本，避免拿旧版本字段对照新文档。
2. 检查当前生效配置的结构和 Provider 名称，但只输出脱敏后的地址，不输出 Key。
3. 先获取当前可用模型列表，再发起一个不含业务资料的短请求。
4. 若失败，保留状态码和已脱敏错误文本，按 Shana API 排错指南 的 401、403、429、502/503 分流。

官方参考与下一步

字段含义和优先级以 Codex 配置参考为准。完成本地核对后，再阅读 Codex 接入 Shana API，最后前往 Shana Codex 接入说明查看实时服务信息。