Skip to main content

​
Prerequisites: Provider CLI

Before using Omnara, install and authenticate a provider CLI. Omnara supports Claude Code and Codex.

​
Claude Code

Two authentication methods:
  1. Claude Code CLI (Recommended): 
    claude /login
  2. Environment Variable (Alternative): 
    export ANTHROPIC_API_KEY=sk-ant-...

​
Codex

  1. Install the Codex CLI
  2. Authenticate: 
    codex login

​
How Authentication Works

When you run omnara for the first time:
  1. Browser opens automatically
  2. Sign in with your preferred method
  3. Return to terminal
  4. Start coding

​
Sign In Options

Email

Email & password

Google

Google account

GitHub

GitHub account

Apple

Apple account

​
Sign Out

omnara auth logout

​
Multi-Device

  • Same account works everywhere
  • Sessions sync in real-time
  • Manage devices from dashboard

​
Security

  • Encrypted token storage (~/.omnara/creds.json)
  • Automatic token refresh
  • TLS for all connections
  • Session isolation

​
Account Deletion

Email [email protected] to request account deletion.

​
Troubleshooting

Install Claude Code:Visit claude.com/product/claude-code to install Claude Code, then authenticate:
claude /login
Or use API key:
export ANTHROPIC_API_KEY=sk-ant-...
omnara
Install Codex and authenticate:
codex login
Remote sandboxing for GitHub repos requires GitHub connection or the Omnara GitHub App.
Verify Claude Code login:
claude --version
Re-authenticate if needed:
claude /login
Copy the URL from terminal and open manually
omnara auth logout
omnara
Check internet connection and firewall settings