Connect Claude Code

3 minute read · Chats & Local Agents

Connect a Claude Code account profile, then choose it for a conversation. Your Vortex sign-in and provider sign-in are separate accounts.

• Connect the account
• Keep provider profiles distinct
• What to expect from Claude Code
• Verify the account with project work
• Choose settings the provider supports
• When sign-in or a run fails

Connect the account#

1. Open Settings → Integrations and select Claude Code.
2. Check installation status. If needed, choose Install and follow preparing, installing and verification progress. An error or cancelled installation needs attention before a run can start.
3. Choose Sign in. Complete the supported browser flow and any displayed provider code, then return to Vortex to verify the account status.
4. Start a new chat, check the intended account profile, then use the provider icon and model picker to choose Claude Code and an available model. Ask it to explain the first step of your app idea.

Keep provider profiles distinct#

Provider accounts can hold multiple profiles for Claude Code. Name each profile so you can recognize the intended account, complete its connection flow and check its status before a run. A saved profile is separate from your Vortex sign-in and from a website login in the chat browser.

If a connection fails, inspect and reconnect the affected profile rather than replacing a working profile. Verify the account and model again before continuing. See provider accounts, models and usage; additional profiles do not include additional provider subscriptions or tokens.

What to expect from Claude Code#

Claude Code is installed separately when needed, rather than bundled into every Vortex update. Preserve an existing detected installation and sign-in. Claude can report five-hour and weekly account usage windows when supplied by its protocol.

If the app reports unknown or signed out, open the connection controls again. An unknown state is not a confirmed sign-in. A provider account rejection needs an eligible account or another supported agent; Vortex does not change provider eligibility or include its tokens.

Continue with your first app, model and usage choices and permissions.

Verify the account with project work#

Create a fresh project conversation, choose Claude Code and ask it to inspect the app before editing: “Explain what starts the frontend and API, then suggest one small improvement.” Confirm that the result describes this checkout. When you are ready, request the improvement, answer any approval in that exact run and inspect the changed files.

Use the installation and connection state shown by Vortex. If Claude is missing, follow its installation flow before starting a run; preserve an existing detected installation and provider sign-in when troubleshooting. Reinstalling Vortex is not the normal way to install the agent.

Choose settings the provider supports#

Select a discovered or supported custom model through the composer. Thinking controls and access choices depend on the model and protocol. Use Supervised when learning the workflow, and read the scope of an approval before granting it. A permissive access mode does not turn a request to edit local code into permission to publish or send external messages.

Account usage can include five-hour and weekly windows. Context consumption is a different measure, and old quota samples should not be read as current after a reset. Your Anthropic subscription and Claude tokens remain separate from Vortex.

When sign-in or a run fails#

Complete the supported browser/account flow, return to the connection dialog and wait for verification. If the account remains unknown, treat that as an unresolved check, not a confirmed connection. For a failed run, retain its error and check model/account availability before retrying. Stopping a run invalidates its pending approvals; approve a new request only in the new run where it appears. Permissions and steering cover those interactions.