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?

First, open a terminal

Every command below is typed into a terminal. You only need it for setup.

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

2. Sign in

codex login

Your browser opens. Choose to sign in with ChatGPT.

3. Check it works

codex login status

It 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

2. Sign in

claude auth login

Your browser opens. Sign in with the account that has the paid plan.

3. Check it works

claude auth status

Source: 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.

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

2. Download a model

ollama pull qwen3:8b

About 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.