Codex 接入 Shana API：Base URL 与 Responses 的配置要点

将 Codex 接入 Shana 前，应先分清三类信息：服务地址、协议形式和密钥保存位置。Shana 的 Base URL 是 https://shana.baby/v1，请求采用 Responses 形式。具体字段名会随客户端版本变化，因此应以当前客户端的官方配置说明和 Shana 文档为准，而不是照搬旧截图。

配置前的最小核对

1. 在本地客户端或 CLI 的受控配置位置填写 Base URL：https://shana.baby/v1。
2. 确认所选客户端使用 Responses，而不是把旧的请求格式混入当前配置。
3. 把 API Key 仅放入本地环境变量、系统凭据或客户端的私有配置。示例中只能使用 YOUR_SHANA_API_KEY 这类占位符。
4. 先发起一个无敏感内容的短请求，确认返回格式、错误信息和日志位置都可读。

可复现操作案例

创建一个仅含占位符的本地测试配置：Base URL 填写 https://shana.baby/v1，协议选择 Responses，Key 使用本机受控凭据中的测试值。运行一次简短的测试请求后，删除测试提示词中的任何项目名称或个人资料，只保留状态码与已脱敏的请求标识用于排错。

密钥与浏览器的边界

网页文章不能代替密钥管理器。不要让浏览器本地存储、扩展脚本或网页 JavaScript 保存、读取或代发你的 Key；也不要把 Key 放进 URL、截图、提交记录或聊天消息。若需要更换 Key，请在服务端或本地客户端的受控配置中完成，再重新测试。

何时停止继续尝试

遇到认证、权限或协议错误时，不要反复粘贴 Key。先核对 Base URL、Responses 选择和本地配置是否生效，再查看 Shana Codex 接入说明。