# Shana API

一个 OpenAI 兼容接口，少改配置即可连接 Codex、CC Switch 与常用客户端。进入 Shana 创建 API Key，填写 https://shana.baby/v1，使用 Responses 协议开始调用。

## Canonical content

- [Shana API 接入排错指南：401、403、429、502/503 与路径检查](https://www.shanababy.com/guides/shana-api-error-guide.html): 按认证、权限、限流、临时错误和重复路径逐层排查 Shana API 接入，并使用有界重试。
- [Codex Skills 示例：代码审查、资料整理与重复流程固化](https://www.shanababy.com/guides/codex-skills-examples.html): 用三个带锚点的可复现操作案例说明如何将明确边界的工作写成 Codex Skills。
- [Codex Skills 安装指南：项目目录、用户目录与 SKILL.md](https://www.shanababy.com/guides/codex-skills-install.html): 明确 Codex Skills 的项目级与用户级路径，给出 $skill-installer linear 和手工 SKILL.md 的可审查安装步骤。
- [用 CC Switch 配置 Codex 与 Shana：按字段语义完成接入](https://www.shanababy.com/guides/cc-switch-shana-codex.html): 以当前 Release v3.19.2 为核验版本，使用三张 v3.16.5 旧 UI 截图说明字段语义与完整配置顺序。
- [Codex 接入 Shana API：Base URL 与 Responses 的配置要点](https://www.shanababy.com/guides/codex-shana-api-setup.html): 用可核对的配置步骤将 Codex 接到 Shana API，并避免在浏览器或公开文本中暴露 Key。
- [Codex 下载与安装：ChatGPT 桌面入口和 CLI 的安全起步](https://www.shanababy.com/guides/codex-download-install.html): 从 ChatGPT 官方下载页进入桌面体验，或在 Windows 使用官方 PowerShell、npm 安装 Codex CLI。
- [遇到 429、502 或 503，应如何处理？](https://www.shanababy.com/faq/shana-rate-or-server-errors.html): 429、502/503 只做最多三次的有界重试，间隔 2 秒、4 秒、8 秒；持续失败则停止并记录脱敏信息。
- [遇到 401 或 403 时，第一步该查什么？](https://www.shanababy.com/faq/shana-auth-errors.html): 401 先查本地 Key 配置是否生效；403 先查身份、访问范围或服务端策略，二者都不应重试。
- [可以把 Shana API Key 放进浏览器或网页脚本吗？](https://www.shanababy.com/faq/api-key-browser-safety.html): 不可以。Key 应留在本地受控凭据或服务端环境中，浏览器不存储也不调用 Key。
- [Codex Skills 应从哪里安装？](https://www.shanababy.com/faq/codex-skills-where-to-start.html): 项目技能使用 $CWD/.agents/skills，用户技能使用 $HOME/.agents/skills，每个有效目录含 SKILL.md。
- [CC Switch 截图和我的界面不同，应该怎么办？](https://www.shanababy.com/faq/cc-switch-old-screenshot.html): 本站截图取自 v3.16.5 旧 UI；当前 Release 核验为 v3.19.2，应按字段语义而非位置操作。
- [为什么要确认 Responses 协议？](https://www.shanababy.com/faq/shana-responses-protocol.html): Base URL 与协议必须匹配；使用 Responses 的客户端不应手工把 /responses 或 /chat/completions 追加到地址。
- [Shana 的 Base URL 应填写什么？](https://www.shanababy.com/faq/shana-base-url.html): Base URL 为 https://shana.baby/v1；填写后确认客户端使用 Responses，不手工重复拼接路径。
- [我应使用 ChatGPT 桌面入口还是 Codex CLI？](https://www.shanababy.com/faq/codex-desktop-or-cli.html): 桌面入口在 ChatGPT 官方下载页；终端工作流可用官方 PowerShell 或 npm 安装 Codex CLI。