Skip to main content
Chucky supports multiple AI providers, giving you flexibility to choose the best model for each task.

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 the or: 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

  1. Go to Billing → Custom Pricing in the portal
  2. 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:
  1. Custom exact match - Your pricing for the exact model name
  2. Custom wildcard - Your pricing matching provider/*
  3. Built-in pricing - Known Anthropic/OpenAI prices
  4. Default fallback - Sonnet-level pricing (3/3/15 per 1M tokens)
If you use free models without custom pricing, they’ll be billed at the default rate. Add custom pricing with $0 for free models.

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:
Fix: Add the API key in project settings.

Model Not Found

OpenRouter may not have the model:
Fix: Check model name at openrouter.ai/models.

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