Supported Providers
Using Different Models
Anthropic (Default)
OpenAI
Use your own OpenAI API key for GPT models:Add your OpenAI API key in the project settings at app.chucky.cloud.
OpenRouter
Access 100+ models through OpenRouter using theor: prefix:
Add your OpenRouter API key in the project settings. Get one at openrouter.ai.
Model Detection
Chucky automatically routes requests based on the model name:Examples
Environment Variables
Configure Claude Code model behavior via environment variables passed to sessions:Primary Model
Model Aliases
Override the default models for each alias tier:Subagent Model
Prompt Caching
Control prompt caching behavior:These environment variables are passed to the Claude Code sandbox and affect how models are selected for different tasks within a session.
Custom Pricing
For OpenRouter and other non-standard models, you can configure custom pricing to ensure accurate cost tracking.Why Custom Pricing?
- OpenRouter models have varying prices
- Some models are free (e.g.,
mistralai/devstral-2512:free) - Accurate billing for your users
Setting Up Custom Pricing
- Go to Billing → Custom Pricing in the portal
- Add pricing entries for models you use
Wildcard Patterns
Use/* suffix to match all models from a provider:
Pricing Priority
When calculating costs, Chucky checks in order:- Custom exact match - Your pricing for the exact model name
- Custom wildcard - Your pricing matching
provider/* - Built-in pricing - Known Anthropic/OpenAI prices
- Default fallback - Sonnet-level pricing (15 per 1M tokens)
Example: Free Models
For free OpenRouter models:Provider Configuration
Adding API Keys
In the portal at Projects → [Your Project] → Settings:1
Anthropic API Key
Required for Claude models. Get one at console.anthropic.com.
2
OpenAI API Key
Required for GPT models. Get one at platform.openai.com.
3
OpenRouter API Key
Required for OpenRouter models. Get one at openrouter.ai.
Custom OpenRouter Endpoint
For self-hosted OpenRouter or compatible APIs:Model Recommendations
Troubleshooting
”No API key configured”
You’re using a model that requires your own API key:Model Not Found
OpenRouter may not have the model:Unexpected Costs
Model billed at default rate instead of actual price: Fix: Add custom pricing for the model in Billing → Custom Pricing.Next Steps
Custom Pricing
Configure model pricing
Budget Management
Control costs per user
Sessions
Working with sessions
OpenRouter
Browse available models