anth-prod-checklist

# Anthropic Production Checklist ## Overview Complete checklist for deploying Claude API integrations to production with reliability, observability, and cost controls. ## Pre-Launch Checklist ### Authentication & Keys - [ ] Production API key from dedicated Workspace - [ ] Key stored in secret manager (not env files on servers) - [ ] Key rotation procedure documented and tested - [ ] Separate keys for each environment (dev/staging/prod) ### Error Handling - [ ] All 5 error types handled: `authentication_error`, `invalid_request_error`, `rate_limit_error`, `api_error`, `overloaded_error` - [ ] SDK `maxRetries` set (recommended: 3-5 for production) - [ ] Custom error logging with `request-id` captured - [ ] Circuit breaker for sustained API failures ### Rate Limits & Cost - [ ] Usage tier verified at [console.anthropic.com](https://console.anthropic.com/settings/limits) - [ ] Application-level rate limiting implemented - [ ] Cost alerts configured (monthly spend caps) - [ ] Model selection optimized (Haiku for simple tasks, Sonnet for complex) - [ ] `max_tokens` set to realistic values (not inflated) - [ ] Prompt caching enabled for repeated system prompts ### Reliability - [ ] Timeout configured (`timeout` parameter, recommended 60-120s) - [ ] Graceful degradation when API is unavailable - [ ] Health check endpoint tests API connectivity ```python async def health_check(): try: # Use token counting as a cheap health probe (no generation cost) count ...