Aider [BETA]

Point Aider at Chutes with OpenAI-compatible HTTP.

Aider does not use MCP in the toolkit reference. It sends OpenAI-like payloads with Bearer auth and a live model ID from /v1/models.
Open source guideConnect quickstarts
Aider setupOpenAI-compatible guideGenerator script
Status
[BETA] Aider round-trip boundary
Base URL
https://llm.chutes.ai/v1
Live model example
Qwen/Qwen3-32B-TEE
Catalog checked
Jun 25, 2026; context 40K

Full setup walkthrough

Everything you need is on this page — no need to leave for the toolkit. Each step is copy-paste runnable and uses a live model id from the catalog.

  1. 01

    Generate the Aider config

    Aider speaks the OpenAI HTTP API directly — no MCP. The generator writes ~/.aider.conf.yml:
    generate + ~/.aider.conf.yml
    yaml
    python plugins/chutes-ai/skills/chutes-mcp-portability/scripts/generate_agent_config.py \
  --target aider --out ~

# ~/.aider.conf.yml
openai-api-base: https://llm.chutes.ai/v1
openai-api-key: ${CHUTES_API_KEY}
model: Qwen/Qwen3-32B-TEE
edit-format: diff
  2. 02

    Provide the API key

    Store your cpk_ key as CHUTES_API_KEY in the environment or a secret store. Send it as Authorization: Bearer — never X-API-Key, which inference ignores.
    bash
    export CHUTES_API_KEY=cpk_...
  3. 03

    Pick a model — or an inline pool

    Aider passes the model string straight through, so a live ID or an inline routing pool both work as the model value:
    yaml
    model: Qwen/Qwen3-32B-TEE
# or pass a failover/latency pool as the model:
model: Qwen/Qwen3-32B-TEE,zai-org/GLM-5-TEE:latency
  4. 04

    Verify the round-trip

    Run aider --version, then a small test edit. The first line of output should show the Chutes model id.
    edit-format: diffis the most forgiving format. "Unknown model" means Aider's hardcoded list doesn't include it — trust /v1/models and proceed.

Aider passes the model string through

Transport
OpenAI-compatible HTTP, not MCP.
Model
Qwen/Qwen3-32B-TEE
Status
[BETA] because the endpoint/auth were verified, but not a full Aider round trip.
Edit format
The reference uses diff as the forgiving default.

Troubleshooting

Symptom
The model ID fails
Likely cause
The catalog changed or the client cached model metadata.
Fix
Refresh /v1/models and update the config.
Symptom
Auth falls into anonymous limits
Likely cause
The key is missing or not sent as Bearer auth.
Fix
Export CHUTES_API_KEY=cpk_... and send Authorization: Bearer.
Symptom
Routing aliases fail
Likely cause
Saved default aliases need a dashboard Model Routing pool.
Fix
Use a concrete model ID or an inline comma-separated pool first.