Aider with FluxCDN AI
Aider works next to git in the terminal, writes changes straight into your files and commits them. It doesn't need tool calling, so almost any chat model in our catalog can drive it.
- Licence:
- Apache-2.0, open source
- Platforms:
- macOS, Linux, Windows (Python 3.10 to 3.12)
- Address (OpenAI-compatible):
https://ai.fluxcdn.cloud/api/v1
Before you start
- Create an API key. On the API keys page press “Create key” and copy the key right away. It starts with
flux_live_and is never shown in full again. - Give agents a key of their own and set a daily or monthly spending limit on it with “Limits”. Agents send request after request by themselves; the limit stops spending you didn't expect.
- Have some credit in the account (Billing).
- In the examples, put your own key where it says
flux_live_YOUR_KEY.
Set it up
Step 1: Pick a model setup and save the settings
The simplest place is
.aider.conf.ymlin your home folder. Don't put it in the project folder, so the key isn't committed with the code. Putopenai/before the model id: Aider (through LiteLLM) removes the first part and sends the rest to FluxCDN.weak-modelwrites commit messages and summaries.Price per million tokens. Free plan prices, in Toman at today's rate. Routers (
router/autoand the like) are not recommended for agents: an agent needs a model that is sure to support tools.~/.aider.conf.ymlopenai-api-base: https://ai.fluxcdn.cloud/api/v1 openai-api-key: flux_live_YOUR_KEY model: openai/anthropic/claude-sonnet-5.5 weak-model: openai/anthropic/claude-haiku-5.5The “model metadata” tab is optional: it tells Aider the model's real size so it stops warning “Unknown context window”. The cost is set to zero; see the real cost under Activity.
Step 2: Start Aider
Run
aiderin your project folder (a git repository) and add the files to change to the chat.Terminalcd your-project aider
Check it works
Step 1: Send one message and exit
Aider sends one message, prints the answer and exits.
Terminalaider --message "Say hello in one sentence"
Troubleshooting
- Aider asks for another service's key (such as
ANTHROPIC_API_KEY) or answers 404 - The
openai/before the id is missing, so Aider sent the model to its maker's own service. Right:openai/anthropic/claude-sonnet-5.5;openai/is for Aider andanthropic/is part of our id. - The warning “Unknown context window size and costs”
- Harmless. To stop it, create the “model metadata” file from step 1.
- Error 401 or
invalid_api_key - The key wasn't copied whole, was revoked, or went in the wrong field. It starts with
flux_live_and has no spaces. If the tool reads it from an environment variable, open a new terminal or window after setting it. - Error 402,
insufficient_credit(in Codex:insufficient_quota) although you have credit - Before each request, the most it could cost is set aside from your credit. When the answer ends, only the real cost is taken and the rest is released. A tool that asks for a very long output on every request sets aside a large amount. Lower the tool's output limit (for example to 32000 tokens) or add credit.
- A 404 that doesn't mention the model
- The base address is wrong. Most tools want
https://ai.fluxcdn.cloud/api/v1and add the rest themselves; don't write/chat/completionstwice and don't leave out/v1. See the which address table. - Error 429:
rate_limit_exceededorbudget_exceeded - Either requests per minute went over the limit (wait a little; most tools retry by themselves), or this key's spending today or this month reached its limit. See it on API keys under “Limits”.
- Error 502, 503, 504 or 529
- The model's service was briefly unavailable. Send again; most tools do it themselves. A request that fails before answering costs nothing. If it lasts, switch to another model for a while.
Limits
- The cost Aider shows doesn't come from FluxCDN; see the real cost under Activity.

