Quick Start

Get started with Xynaa API in minutes. We provide Claude API access without a waitlist, with drop-in compatibility and built-in tools.

Prerequisites

  • ✓ Node.js 18+
  • ✓ Xynaa API key
  • ✓ Supported IDE (Claude Code, VS Code, Cursor, Windsurf, Cline, or Roo Code)

Installation

Choose your preferred installation method:

Interactive Setup

npx xynaa

Windows (PowerShell)

irm https://xynaa.com/setup.ps1 | iex

macOS / Linux (Shell)

curl -fsSL https://xynaa.com/setup.sh | sh

Configuration

Add your API credentials to the settings file:

Claude Code / VS Code

Edit ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.xynaa.com",
    "ANTHROPIC_MODEL": "Sonnet 4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "Haiku 4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "hasCompletedOnboarding": true
}

Cursor

Add as OpenAI-compatible model:

  • Base URL: https://api.xynaa.com/v1
  • Model: claude-sonnet-4-6

Windsurf

Configure base URL:

https://api.xynaa.com/v1

Cline / Roo Code

Add to VS Code settings.json:

{
  "cline.apiProvider": "anthropic",
  "cline.anthropicBaseUrl": "https://api.xynaa.com",
  "cline.anthropicApiKey": "YOUR_API_KEY"
}

Authentication

Include your API key in all requests using one of these methods:

Header

# Option 1
x-api-key: YOUR_API_KEY

Bearer Token

# Option 2
Authorization: Bearer YOUR_API_KEY

API Endpoints

POST/v1/messagesCreate message (supports streaming)
GET/v1/modelsList available models
POST/v1/messages/count_tokensCount tokens
GET/key-status?key=Check key status and usage
POST/tools/web_searchReal-time web search
POST/tools/understand_imageImage analysis (max 18MB)

Available Models

ModelTierModel ID
Opus 4.6Premiumclaude-opus-4-6
Sonnet 4.6Popularclaude-sonnet-4-6
Haiku 4.5Fastclaude-haiku-4-5-20251001

Shortcuts: opus, sonnet, haiku, or gpt-4 map to these models.

Built-in Tools

🌐

Web Search

Get real-time information from the web. No client setup required - tools are built into the server.

🖼️

Image Analysis

Analyze images up to 18MB. Server-side processing means no additional client configuration needed.

Troubleshooting

Connection errors

Check your API key validity and ensure you have an active subscription.

Web search not working

Our tools are built-in server-side - no additional setup required.

Model not found

Use exact model IDs listed in the models section above.

Rate limited

Check your 5-hour token window using the Key Status page.

Config not applying

Restart your IDE after making configuration changes.

Cursor/Windsurf routing

Use the /v1 endpoint URL (e.g., https://api.xynaa.com/v1).