Codex API 生产环境接入清单

本地请求成功只是起点。把 API 放进生产服务前，至少确认以下项目。

鉴权和权限

• 密钥只在服务端环境变量或密钥管理系统中保存。
• 为不同环境使用不同密钥，并设置最小权限。
• 定期轮换密钥，发现泄露时立即撤销。

稳定性

• 设置连接和整体请求超时。
• 只对明确可重试的错误做指数退避，限制最大次数。
• 对 429 和 5xx 设计用户可理解的降级响应。
• 记录 request id、状态码和耗时，避免记录完整敏感输入。

成本和质量

• 给单个用户、任务和团队设置配额。
• 统计输入输出 token、失败率和平均延迟。
• 用固定样例做回归评估，再调整提示词或模型。

数据处理

明确哪些数据可以发送到 API，敏感字段是否需要脱敏，日志和缓存的保留周期是什么。把这些规则写进代码审查清单，避免只靠口头约定。

需要 API 入口和账户配置时，访问 api.clawsocket.com。