Setup Guide
Get Omega V1 running inside your IDE or AI client with the real local proxy URL, Omega model IDs, and Anthropic-compatible endpoints.
Prerequisites
If Node.js is not installed, download the official installer from nodejs.org, then reopen your terminal and run the setup command.
Quick Setup
Run the Omega Plus setup wizard, paste your API key, then choose the coding tool you want to configure.
npx -y @kesarcloud/omega-plus-cli
API origin: https://omega.kesarcloud.in Anthropic-compatible URL: https://omega.kesarcloud.in/v1 OpenAI-compatible URL: https://omega.kesarcloud.in/api/v1 API Key: YOUR_API_KEY Primary model: omega-v1-pro Fast model: omega-v1
Interactive Setup Flow
The wizard keeps the API key out of the shell history, detects installed tools, and writes the right config for the selected tool.
What the user sees
Omega Plus banner appears in the terminal.
User pastes the Omega API key when prompted.
Wizard validates the key and lists available coding tools.
User enters the tool number, then Omega Plus writes the config.
User opens or restarts the selected coding tool.
Claude Code CLI
Recommended: run the Omega Plus wizard and select Claude Code from the tool list. The wizard writes ~/.claude/settings.json for you.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool claude --api-key YOUR_API_KEY
Manual fallback: create or edit this file, then restart Claude Code.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://omega.kesarcloud.in/v1",
"ANTHROPIC_MODEL": "omega-v1-pro",
"ANTHROPIC_SMALL_FAST_MODEL": "omega-v1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"hasCompletedOnboarding": true
}OpenAI Codex CLI
Recommended: run the Omega Plus wizard and select OpenAI Codex CLI. Codex uses the OpenAI-compatible Omega endpoint.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool codex --api-key YOUR_API_KEY
Manual fallback: set the Omega provider in ~/.codex/config.toml, then keep the API key in ~/.codex/auth.json.
model = "omega-v1-pro" model_provider = "omega" [model_providers.omega] name = "Omega Plus" base_url = "https://omega.kesarcloud.in/api/v1" wire_api = "chat" env_key = "OPENAI_API_KEY"
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}OpenCode
Recommended: run the Omega Plus wizard and select OpenCode. The wizard writes the provider block in ~/.config/opencode/opencode.json.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool opencode --api-key YOUR_API_KEY
Manual fallback: add the Omega Plus provider and choose the Omega model.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"omega": {
"npm": "@ai-sdk/anthropic",
"name": "Omega Plus",
"options": {
"baseURL": "https://omega.kesarcloud.in/v1",
"apiKey": "YOUR_API_KEY"
},
"models": {
"omega-v1-pro": { "name": "Omega V1 Pro" },
"omega-v1": { "name": "Omega V1" }
}
}
}
}Cline
Recommended: run the Omega Plus wizard and select Cline. If Cline is not installed, install the extension first, then rerun the wizard.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool cline --api-key YOUR_API_KEY
Manual fallback: use Anthropic-compatible mode with the Omega endpoint.
{
"actModeApiProvider": "anthropic",
"planModeApiProvider": "anthropic",
"anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
"anthropicModelId": "omega-v1-pro",
"planModeAnthropicModelId": "omega-v1-pro"
}Kilo Code
Recommended: run the Omega Plus wizard and select Kilo Code. The wizard configures Kilo with the Anthropic-compatible Omega endpoint.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool kilo --api-key YOUR_API_KEY
Manual fallback: add the Anthropic auth block for Omega Plus.
{
"anthropic": {
"type": "api-key",
"apiKey": "YOUR_API_KEY",
"baseUrl": "https://omega.kesarcloud.in/v1",
"model": "omega-v1-pro"
}
}Factory Droid
Recommended: run the Omega Plus wizard and select Factory Droid. If Droid is missing, install it first, then rerun the wizard.
npx -y @kesarcloud/omega-plus-cli
npx -y @kesarcloud/omega-plus-cli configure --tool droid --api-key YOUR_API_KEY
Manual fallback: add a custom Anthropic-compatible model entry.
{
"model": "omega-v1-pro",
"id": "custom:OmegaPlus-0",
"baseUrl": "https://omega.kesarcloud.in/v1",
"apiKey": "YOUR_API_KEY",
"displayName": "Omega V1 Pro",
"provider": "anthropic"
}Manual IDE Configuration
Use this section for tools that are not automated by the Omega Plus npm wizard, or when you prefer to configure a client manually.
VS Code
Use the Claude Code settings file above, then restart VS Code.
Cursor
Models > Add compatible model with Base URL https://omega.kesarcloud.in/v1 and model omega-v1-pro.
Windsurf
AI Provider settings should use https://omega.kesarcloud.in/v1 as the base URL.
Cline
Set apiProvider to anthropic and use the Omega base URL with your API key.
Roo Code
Set roo-cline.apiProvider to anthropic and use your Omega API key.
{
"cline.apiProvider": "anthropic",
"cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
"cline.apiKey": "YOUR_API_KEY"
}{
"roo-cline.apiProvider": "anthropic",
"roo-cline.anthropicBaseUrl": "https://omega.kesarcloud.in/v1",
"roo-cline.apiKey": "YOUR_API_KEY"
}OPENAI_API_KEY=YOUR_API_KEY OPENAI_BASE_URL=https://omega.kesarcloud.in/api/v1 MODEL=omega-v1-pro
Authentication
Proxy endpoints accept API key authentication through either header. Dashboard endpoints use JWT tokens returned from the login endpoint.
x-api-key: YOUR_API_KEY # OR Authorization: Bearer YOUR_API_KEY
/v1/messagesMessages
Create a message with Anthropic-compatible request and response shape. Set stream: true for SSE streaming.
{
"model": "omega-v1-pro",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Hello, Omega!" }
],
"stream": false
}/v1/modelsModels
List all available public Omega model IDs.
{
"data": [
{
"id": "omega-v1",
"object": "model",
"display_name": "Omega V1"
},
{
"id": "omega-v1-pro",
"object": "model",
"display_name": "Omega V1 Pro"
}
]
}/v1/messages/count_tokensToken Counting
Count tokens for a message without sending it to a provider.
{
"model": "omega-v1-pro",
"messages": [
{ "role": "user", "content": "How many tokens is this?" }
]
}/api/auth/loginDashboard Auth
Use this route to sign in to dashboard sessions.
{
"email": "YOUR_EMAIL",
"password": "YOUR_PASSWORD"
}Available Models
Omega V1
omega-v1Default Omega V1 production-grade coding and work model experience.
Omega V1 Pro
omega-v1-proHigher-capacity Omega V1 profile for heavier coding, UI, and agentic workflows.
Build Notes
Built-in search and vision
Omega Plus does not require MCP servers or third-party tools for web search and image understanding. Omega V1 and Omega V1 Pro include built-in web search and full vision capability, so both models can work with text and image inputs directly.
Troubleshooting
Confirm the API server is running at https://omega.kesarcloud.in.
Use exact model IDs from the Available Models section.
Your five-hour token window or RPM cap may be exhausted.
Restart your IDE after any config change.
Make sure the base URL ends with /v1.
