Connect your AI
The StudyBirds desktop app does not come with its own AI. It uses one you already have: a ChatGPT or Claude plan through its command-line tool, an API key, or a free model on your computer. These guides get one ready.
StudyBirds works with Codex, Claude Code, OpenAI-compatible API keys and models run by Ollama or LM Studio. Commands and plans below were checked against each maker's own pages on 21 November 2026 and can change.
Which one should I use?
- I pay for ChatGPT Plus or higher Codex. It is part of your plan.
- I pay for Claude Pro or higher Claude Code. It is part of your plan.
- I have neither plan An API key, paid per use, or Google's free allowance.
- I want nothing to leave my computer Ollama, which runs a model locally. It needs a fairly strong computer.
First, open a terminal
Every command below is typed into a terminal. You only need it for setup.
- Windows: press Start, type
PowerShell, press Enter. - macOS: press Command and Space, type
Terminal, press Enter. - Linux: open your terminal app, often Ctrl, Alt and T.
Codex, from OpenAI
Uses your ChatGPT account. OpenAI lists the command-line tool for Plus and higher plans. Its pricing page says Codex is included in the Free plan too, but does not say clearly that the command-line tool is. Try it after signing in before you pay for anything.
1. Install
-
Windows
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" -
macOS
curl -fsSL https://chatgpt.com/codex/install.sh | sh -
Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
2. Sign in
codex loginYour browser opens. Choose to sign in with ChatGPT.
3. Check it works
codex login statusIt should say you are logged in.
Source: github.com/openai/codex
Claude Code, from Anthropic
Needs a paid Claude plan (Pro, about 20 US dollars a month, or higher). The free Claude plan does not include Claude Code.
1. Install
-
Windows
irm https://claude.ai/install.ps1 | iex -
macOS
curl -fsSL https://claude.ai/install.sh | bash -
Linux
curl -fsSL https://claude.ai/install.sh | bash
2. Sign in
claude auth loginYour browser opens. Sign in with the account that has the paid plan.
3. Check it works
claude auth statusSource: code.claude.com/docs/en/setup
An API key
No plan needed: you pay the provider for what you use, or nothing within a free allowance. In StudyBirds, choose An API key, then pick the provider. It fills in the address and opens the page where you make a key. Paste the key, press Show my models, pick one and test it.
- OpenAI or DeepSeek: paid per use. Building one course from a lecture reads every page, so it costs more than chatting.
- Google Gemini: a key from Google AI Studio has a free allowance with daily limits. Google may use what you send on the free tier to improve its products.
- OpenRouter: many models from one key. Its free models allow only a few dozen requests a day, which is not enough to build a course.
Source: ai.google.dev, OpenAI compatibility ยท openrouter.ai, limits
Ollama (runs on your own computer)
No account and no bill. The model runs on your computer, so answers are slower and weaker than the hosted tools unless the computer is strong.
1. Install
-
Windows
irm https://ollama.com/install.ps1 | iex -
macOS
Download the app from ollama.com/download.
-
Linux
curl -fsSL https://ollama.com/install.sh | sh
2. Download a model
ollama pull qwen3:8bAbout 5 GB. StudyBirds needs at least one model. Small models can struggle to build a course from your files; a bigger one needs a stronger computer.
3. Connect it
In StudyBirds, choose An API key, then Ollama. No key is needed.
Source: docs.ollama.com/quickstart
Then what?
Download StudyBirds. When it asks which AI should tutor you, choose the one you set up here and press Test. It tells you if anything is missing.