ClaudeStore/Docs
⚠ These docs are a work in progress. Some content may be inaccurate or temporarily AI-generated.

Quickstart

Send your first Claude API request in under a minute. Quickstart tutorial with Python, TypeScript, and cURL examples.

Base URL: https://api2.claudestore.store. Endpoint: POST /v1/messages. Auth header: x-api-key: YOUR_KEY. Default model: claude-sonnet-4.6. Time to first call: ~2 minutes.

1. Get Your API Key

Sign up at claudestore.store and create an API key from your dashboard. Your key will look like sk-....

Validate gateway access

Before sending real requests, run two cheap checks: a health probe and a models list. They confirm the base URL, your network, and (for /v1/models) your API key — without spending any credits.

1. Liveness probe — /healthz

Public, unauthenticated. Returns 200 and a JSON status payload when the gateway is up. Use it from CI, monitoring, or any shell.

curl -sS -o /dev/null -w "HTTP %{http_code}\n" \
  https://api2.claudestore.store/healthz

2. Auth + catalogue — /v1/models

Returns the list of model IDs you can use with the messages API. Requires a valid x-api-key. If this works, your key, base URL, and headers are all correct.

curl -sS https://api2.claudestore.store/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'

What a healthy response looks like

  • /healthz → HTTP 200 with {"status":"ok", ...}. Anything else (timeout, 5xx, HTML page) means you hit the wrong host or there is a network/proxy issue.
  • /v1/models → HTTP 200 with {"object":"list","data":[...]}. The data array contains the only model IDs accepted by /v1/messages.

Common mistakes

  • Wrong base URL. The only correct host is https://api2.claudestore.store. Do not use api.anthropic.com, api.claudestore.store (old) or any other variant.
  • Missing /v1 prefix. Endpoints live under /v1/* (e.g. /v1/messages, /v1/models). /healthz is the one exception — it is at the root.
  • Wrong auth header. Use x-api-key: sk-cs2-... (Anthropic-style). Do not send Authorization: Bearer ... unless the SDK builds it for you.
  • Invalid model ID. Only IDs returned by /v1/models work. As of today: claude-sonnet-4.6, claude-haiku-4.5, claude-opus-4.6.

Tip: use /v1/models as the source of truth for model IDs in your scripts and CI — never hard-code a list.

2. Send Your First Request

Anthropic Format

cURL — Anthropic Messages APIbash
curl https://api2.claudestore.store/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'

OpenAI-Compatible Format

cURL — OpenAI Chat Completionsbash
curl https://api2.claudestore.store/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'

3. Set Up IDE Integration

Cursor

Cursor Pro Plan Required

Custom API providers only work on Cursor's paid Pro plan or higher. The pay-as-you-go starter ($5) does not support third-party API keys.

In Cursor Settings → Models → Add Provider:

  • Base URL: https://api2.claudestore.store/v1
  • API Key: your ClaudeStore API key
  • Add model: claude-sonnet-4-20250514

Claude Code

Claude Code CLI uses the v2 gateway at api2.claudestore.store with sk-cs2-* keys. Use ANTHROPIC_API_KEY only — never ANTHROPIC_AUTH_TOKEN.

Linux / macOS:

Set environment variablesbash
export ANTHROPIC_BASE_URL="https://api2.claudestore.store"
export ANTHROPIC_API_KEY="YOUR_SK_CS2_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4.6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"

Windows PowerShell:

Set environment variables (PowerShell)powershell
$env:ANTHROPIC_BASE_URL = "https://api2.claudestore.store"
$env:ANTHROPIC_API_KEY = "YOUR_SK_CS2_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-4.6"
$env:ANTHROPIC_SMALL_FAST_MODEL = "claude-haiku-4.5"

Important

For Claude Code, the base URL must be set without /v1. The CLI appends /v1/messages automatically. See the dedicated Claude Code guide for the full ~/.claude/settings.json template and verification steps.

4. List Available Models

The models endpoint is public and does not require an API key:

curl https://api2.claudestore.store/v1/models

5. Billing Basics

  • Credits start from $5 — no subscriptions, pay as you go
  • You are billed per token (input + output) based on the model used
  • Check your balance anytime in the dashboard
  • Credits never expire
See Pricing for full per-model token rates.

Next Steps

Gateway v2 (Beta)

New: api2.claudestore.store

A second gateway is available in beta with a separate credit pool and sk-cs2-* keys. Create a v2 key in the dashboard under Gateway v2 → Keys. The endpoint surface is identical (/v1/messages, /v1/chat/completions, /v1/models).
cURL — v2 gatewaybash
curl https://api2.claudestore.store/v1/messages \
  -H "Authorization: Bearer sk-cs2-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Hello from v2"}
    ]
  }'

v1 (api2.claudestore.store, sk-... keys) continues to work unchanged. The two pools are billed separately.

Ready to start?

Get API access to all Claude models in under 2 minutes.

View Plans
PreviousModelsNext Authentication