Skip to main content
Onlook’s agent is Claude or ChatGPT. It runs on your Mac and uses your own account and plan. Onlook doesn’t charge for AI use, and you don’t need to install anything else. You connect one the first time you open Onlook, on Explore more ideas, faster. You can connect both, and change the default later in Settings.
  1. Choose Set up Claude.
  2. Onlook checks whether Claude already answers on this Mac (Checking it works). If you already use Claude Code here, that’s usually all it takes.
  3. If you’re not signed in, choose Sign in. Onlook opens claude.com in your browser. Sign in there.
  4. If Claude shows you a code, go back to Onlook, choose Paste, then Done.
When you’re connected, the dialog shows Signed in as your email, and your plan (for example Pro plan). If you use an Anthropic API key instead of a plan, it says API key. Choose Done. The tile says Connected.If the browser sign-in doesn’t finish, Onlook shows Finish signing in from the Terminal. Terminal is the Mac’s built-in app for typing commands, and this line only signs you in.
  1. Choose Copy, then Open Terminal.
  2. Click anywhere inside the Terminal window, press ⌘V to paste, then press Return.
  3. Follow what Claude asks in Terminal, such as signing in in your browser.
  4. When Claude says you’re signed in, close Terminal with ⌘Q. Then go back to Onlook and choose Check again.
When at least one agent is connected, choose Continue. The agent you connected last becomes your default.

​
What the tiles mean

​
Permission modes

To choose how often the agent stops to ask before it acts, use the Permissions menu in the chat box. With Claude, you can pick one of four modes: In every mode, the agent still asks before it pushes to GitHub, creates or merges a pull request, force-pushes, deletes a branch or does a hard reset. With ChatGPT, the menu shows Full access and can’t be changed. The agent works in Onlook’s copy of your code without stopping to ask.

​
Changing your AI later

To change which AI new sessions use, open the projects screen, choose Settings and pick a Default AI. You can also set a default model and reasoning effort there. A project that’s already running keeps its agent.