Connect your Claude subscription

Athena runs on your own Claude plan, on your project's machine. Connect it to start.

Athena runs on your own Claude subscription. You sign in with your Claude account, and Athena does its work with Claude Code, Anthropic's own coding agent, signed in as you. The AI work counts towards your Claude plan. Appentic doesn't charge for it.

Athena won't start a request until you've connected your subscription on the project. Until then, the account button beside the mode picker reads Connect Claude.

Before you start

A paid Claude plan. Pro or Max. You sign in to it on claude.ai.
A machine in the project. Athena works on one of your project's machines. If the project has none yet, add one on the Resources page first. See Machines.
Room on that machine. Athena needs about 512 MB of the machine's memory while it works on a request, and about 320 MB while you sign in. See Resources.

Connect your subscription

Open the project's Athena page.
Click Connect Claude beside the mode picker, under the box. You can also type /connect in the box. Authorise your account opens.
Wait while Athena starts on your machine. The first time takes a minute or two.
Under Sign in, click Sign in. Claude's sign-in page opens in a new tab.
Sign in to Claude, approve the request, and copy the code Claude shows you.
Under Enter your code, paste the code and click Connect.

When it's done, the window shows Connected as you@example.com (Max plan). Click Done. The account button shows Claude · Max, and Athena is ready for your first request. Anything you'd typed in the box is still there.

If you close the window before you finish, click Continue on its line in the conversation to open it again. If you don't paste a code within 15 minutes, signing in stops. Type /connect to start again.

If the project has no machine, or its machine doesn't have room, a dialog says what to do first. Add a machine, or make room on the Resources page, then connect again.

Choose a model and effort

Once you're connected, a button beside the account button shows the model and effort your requests use, such as Opus 5.5 · Medium. Click it to choose another. Your plan decides which models you can use. Your choice is remembered for the project.

Disconnect

Type /disconnect, or choose Disconnect Claude subscription in the account menu, then click Disconnect.

Athena signs you out of Claude on the machine and deletes your sign-in. Athena won't work on the project until you connect again.

You're also signed out when you're removed from the workspace, or when the project or the machine your sign-in is on is deleted.

Resources

Each request runs on your project's machine for as long as Athena works on it:

It needs about 512 MB of free memory to start. It can use more of the machine's idle memory while it works, for example when it opens your app in a browser.
It gives the memory back when the request ends. Between requests, Athena uses nothing on the machine.
The first request takes longer. The first time, and after Athena is updated, the machine downloads Athena before it starts. The page shows Getting Athena ready on machine-1. The first request takes a minute or two.

If the machine doesn't have room, the request stops before it starts:

machine-1 doesn't have room for Athena right now. Athena needs about 512 MB while it works. Lower another resource's memory, or change machine-1 to a larger machine on the Resources page.

To make room, lower the memory of a service on the machine, or change the machine to a larger one. A first build also creates your app's services on the same machine, so a machine with 2 GB or more works best.

Your plan's limits

Requests count towards your Claude plan's usage limits, the same way your own use of Claude does. When your plan reaches its limit, Athena stops and saves where it got to. Ask it to carry on once your plan resets.

If your Claude sign-in expires, Athena stops the same way and asks you to type /connect to sign in again.

Your sign-in is yours. It's used only for your own requests. Each teammate connects their own Claude subscription to use Athena on the project.
Each project has its own. Connecting in one project doesn't connect you in another.
Appentic never sees your Claude password or sign-in. You sign in on claude.ai, and Claude Code signs in with the code Claude gives you.
It stays on your project's machine. It's kept in a folder of its own there, and the commands Athena runs while it builds can't read it. Disconnecting deletes it.