> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Understand Omnara sign-in, provider authentication, and the most common setup issues

## Provider Authentication

Omnara bundles Claude Code and Codex. If your selected provider is already signed in on this machine, Omnara can use it without any extra setup.

If Omnara asks you to authenticate a provider, use one of the flows below.

### Claude Code

You can authenticate Claude Code in either of these ways:

1. **Claude Code CLI**
   ```bash theme={null}
   omnara-claude /login
   ```
2. **Environment variable**
   ```bash theme={null}
   export ANTHROPIC_API_KEY=sk-ant-...
   ```

### Codex

Sign in to Codex when prompted:

```bash theme={null}
omnara-codex login
```

## Omnara Sign-In

When you run `omnara` for the first time:

1. Omnara opens your browser
2. You sign in to your Omnara account
3. You return to the CLI or app
4. Your sessions can now sync across devices

## Sign-In Options

<CardGroup cols={4}>
  <Card title="Email" icon="envelope">
    Email and password
  </Card>

  <Card title="Google" icon="google">
    Google account
  </Card>

  <Card title="GitHub" icon="github">
    GitHub account
  </Card>

  <Card title="Apple" icon="apple">
    Apple account
  </Card>
</CardGroup>

## Sign Out

```bash theme={null}
omnara auth logout
```

## Multi-Device

Once you are signed in, the same Omnara account works across:

* CLI
* web dashboard
* desktop app
* mobile app

## Security

* Encrypted local token storage under `~/.omnara/`
* Automatic token refresh
* TLS for all connections
* Session isolation

## Account Deletion

You can delete your account from Omnara settings in supported clients.

If you are having trouble accessing your account, contact `contact@omnara.com`.

## Common Questions

### “Do I need both Claude Code and Codex?”

No. You only need one provider to start using Omnara.

### “Why does Omnara launch but not start coding?”

Usually this means Omnara sign-in is complete, but your provider is not authenticated yet.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude Code is not detected">
    Make sure Claude Code is authenticated.

    ```bash theme={null}
    omnara-claude /login
    ```

    Or set:

    ```bash theme={null}
    export ANTHROPIC_API_KEY=sk-ant-...
    ```
  </Accordion>

  <Accordion title="Codex is not detected">
    Complete the Codex login flow.

    ```bash theme={null}
    omnara-codex login
    ```
  </Accordion>

  <Accordion title="The browser did not open">
    Copy the sign-in URL from the CLI and open it manually in your browser.
  </Accordion>

  <Accordion title="I signed in to Omnara, but coding still does not work">
    You are probably signed in to Omnara but not to your provider. Check Claude Code or Codex authentication separately.
  </Accordion>

  <Accordion title="I want to use sandboxing but it is blocked">
    Some sandbox flows require workspace sync, checkpoints, or GitHub setup. See the sandbox guide.
  </Accordion>
</AccordionGroup>