Skip to main content
The Edgee CLI is the fastest way to route your AI coding assistant through Edgee. Instead of manually configuring environment variables and API keys, the CLI handles authentication, session tracking, and launching your tool in a single command.

​
Supported Tools

https://mintcdn.com/edgee/RmPUqoqJw-u0FxFP/images/icons/claude.svg?fit=max&auto=format&n=RmPUqoqJw-u0FxFP&q=85&s=d3154991b618d253ee22ffaf55a433fc

Claude Code

Anthropic’s official CLI for interactive coding with AI.
https://mintcdn.com/edgee/CrNen493EQpoYoa2/images/icons/codex.svg?fit=max&auto=format&n=CrNen493EQpoYoa2&q=85&s=0f19fa96ee1277109c66c3b411f868c0

Codex

OpenAI’s CLI agent for software engineering tasks.
https://mintcdn.com/edgee/q0pRfKOA-_MkO9qY/images/icons/opencode.svg?fit=max&auto=format&n=q0pRfKOA-_MkO9qY&q=85&s=ea2fc548940c74f99826d9c3f651e2ad

OpenCode

Open-source AI coding agent with multi-model support.
https://mintcdn.com/edgee/CrNen493EQpoYoa2/images/icons/cursor.svg?fit=max&auto=format&n=CrNen493EQpoYoa2&q=85&s=3de2173fea07b96507ee8bd0e351149f

Cursor

Coming soon.

​
Installation

curl -fsSL https://edgee.ai/install.sh | bash
Verify the installation: 
edgee --version

​
Quick Start

Launch your coding agent 
edgee launch claude
That’s it. Your coding agent is now running with Edgee compression and observability enabled. After your session ends, the CLI prints a link to view your session analytics in the Edgee Console.

​
Commands

​
Anthentication commands

​
edgee auth login

Authenticate with Edgee for a specific provider. Opens a browser window for OAuth-based login. Your API key and credentials are saved to ~/.config/edgee/credentials.toml. If you want to use multiple Edgee profiles, you can add --profile <profile-name> to this command to declare the profile you want to use. 
edgee auth login

​
edgee auth status

Display the current authentication status for all configured providers, including the logged-in email and connection mode. 
edgee auth status

​
edgee auth list

List all configured profiles. Yes, because you can have multiple Edgee profiles, using --profile <profile-name> when you log in. 
edgee auth list

​
edgee auth switch

Switch to a different profile. 
edgee auth switch

​
Launch commands

Launch your coding agent. 
edgee launch

​
edgee launch claude

Launch Claude Code with all Edgee configuration automatically injected. The CLI sets the required environment variables (ANTHROPIC_BASE_URL, authentication headers, session ID) and starts Claude Code. 
edgee launch claude
You can pass any Claude Code arguments after the command: 
edgee launch claude "How do I implement a binary search?"
edgee launch claude --resume
If you haven’t authenticated yet, the CLI will prompt you to log in first. It will also ask you to select a connection mode on first launch:
  • Claude Pro/Max: uses your Anthropic subscription, Edgee compresses traffic to extend session duration
  • API Billing: uses Edgee API keys for direct billing, reducing token costs

​
edgee launch codex

Launch Codex with Edgee routing automatically configured. The CLI passes the required provider configuration to Codex and starts a new session. 
edgee launch codex
You can pass any Codex arguments after the command: 
edgee launch codex --model o4-mini
Connection modes for Codex:
  • ChatGPT Plus/Pro: uses your OpenAI subscription with Edgee compression
  • API Billing: uses Edgee API keys for direct billing

​
Other commands

​
edgee stats

Show the stats of your latest sessions. 
edgee stats

​
edgee alias

Install shell aliases for Edgee launch commands, so you won’t need to launch edgee launch <tool> every time. 
edgee alias

​
edgee reset

Reset your credentials and connection mode for a provider. Useful if you need to switch accounts, change your connection mode, or re-authenticate. 
edgee reset

​
edgee self-update

Check for updates and install the latest version of the Edgee CLI. 
edgee self-update

​
Configuration

The CLI stores credentials in ~/.config/edgee/credentials.toml with restricted file permissions (600). 
version = 2

[claude]
api_key = "ek_..."
email = "you@example.com"
connection = "plan"  # or "api"

[codex]
api_key = "ek_..."
email = "you@example.com"
connection = "plan"  # or "api"
You don’t need to edit this file manually. The CLI manages it through edgee init, edgee auth login, and edgee reset.

​
Session Tracking

Every edgee launch session is assigned a unique session ID. After your session ends, the CLI prints a link to view detailed analytics for that session in the Edgee Console, including:
  • Token usage and compression savings
  • Request count and latency
  • Cost breakdown

​
How It Works

When you run edgee launch claude or edgee launch codex, the CLI:
  1. Verifies your authentication (prompts login if needed)
  2. Generates a unique session ID
  3. Configures the appropriate environment variables and headers
  4. Launches the AI tool as a child process with Edgee routing enabled
  5. Prints a session analytics URL when the session ends
All requests from your coding session flow through Edgee’s API, where token compression, cost tracking, and observability are applied automatically.

​
Next Steps