diff --git a/aider/website/docs/troubleshooting/models-and-keys.md b/aider/website/docs/troubleshooting/models-and-keys.md index 8c6af3543..06fbc9722 100644 --- a/aider/website/docs/troubleshooting/models-and-keys.md +++ b/aider/website/docs/troubleshooting/models-and-keys.md @@ -5,7 +5,27 @@ nav_order: 28 # Models and API keys -You need to tell aider which LLM to use and provide an API key. +Aider needs to know which LLM model you would like to work with and which keys +to provide when accessing it via API. + +## Defaults + +If you don't explicitly name a model, aider will try to select a model +for you to work with. + +First, aider will check which +[keys you have provided via the environment, config files, or command line arguments](https://aider.chat/docs/config/api-keys.html). +Based on the available keys, aider will select the best model to use. + +If you have not provided any keys, aider will offer to help you connect to +[OpenRouter](http://openrouter.ai) +which provides both free and paid access to most popular LLMs. +Once connected, aider will select the best model available on OpenRouter +based on whether you have a free or paid account there. + +## Specifying model & key + +You can also tell aider which LLM to use and provide an API key. The easiest way is to use the `--model` and `--api-key` command line arguments, like this: