Quick Start Guide

Set up AiKey Personal Edition and start managing your AI credentials with local-first security and real-time cost transparency.

1

Install CLI & Source

Run the installer and apply the path changes to your current shell session.

Install Stable
curl -fsSL https://github.com/aikeylabs/launch/releases/latest/download/latest-install.sh | sh
Source Path
source ~/.zshrc # or ~/.bashrc
2

Open AiKey Web

Launch the local console in your browser to manage your Vault and view statistics.

aikey web
3

Vault & Install Hook

Add your credentials to the local Vault. You can use API keys, OAuth logins, or bulk import.

API Key (CLI)

aikey add my-key

Securely adds an API key to your local encrypted vault.

OAuth Account

aikey auth login claude

Add provider subscriptions (Pro/Max) without an API key.

Crucial: After adding a key, click the "Install hook" banner in the Web UI to enable auto-injection of keys for CLIs like claude or kimi.

4

Run Chat & Read Receipts

Open a new terminal and run your preferred model CLI. AiKey will print a cost receipt after the session.

claude # or kimi / codex
After session exit:
[AiKey] Cost Receipt: 1.2k tokens used (~$0.02)
5

Switching Keys

Seamlessly switch accounts even mid-conversation without exiting your terminal session.

aikey use [alias]
Global switch. Affects all new terminal windows and active sessions.
aikey activate [alias]
Temporary switch for the current terminal only. Use aikey deactivate to revert.
6

View Statistics

Return to aikey web to analyze usage trends, token distribution, and cost breakdowns across all providers.

CLI Reference

Identity & Env

aikey whoami aikey list aikey env aikey env set KEY=VAL

System & Routing

aikey route aikey test --all aikey doctor aikey proxy restart

Automation

aikey run -- python eval.py aikey key sync