Zenoid // Tutorial

Tutorial

Подключение к Zenoid из любого Anthropic-совместимого клиента. FREE — клиент бесплатный и поддерживает кастомный URL. PAID — нужна платная подписка клиента, чтобы вставлять свой API-key / URL. ENTERPRISE — кастомный endpoint только на корпоративном тарифе.

// setup.sh

Claude Code · .bat FREE

Claude Code · PowerShell FREE

Claude Code · .sh FREE

Cursor PRO

Windsurf ENT

Aider FREE

Cline / Roo Code FREE

Zed FREE

Continue.dev FREE

OpenCode FREE

Goose FREE

Anthropic SDK FREE

LiteLLM (OpenAI-bridge) FREE

curl FREE

Сохрани как start-claude.bat рядом с claude.exe и запусти двойным кликом. Сам Claude Code CLI бесплатный — платишь только за токены через Zenoid.

@echo off
set ANTHROPIC_BASE_URL=https://api.zenoid.space
set ANTHROPIC_AUTH_TOKEN=sk-zen-вставь-свой-ключ
set ANTHROPIC_API_KEY=sk-zen-вставь-свой-ключ
set ANTHROPIC_MODEL=claude-sonnet-4-7
set ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-7
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude %*

Сохрани как start-claude.ps1. Запуск: powershell -ExecutionPolicy Bypass -File .\start-claude.ps1 (или просто .\start-claude.ps1, если политика разрешает).

$env:ANTHROPIC_BASE_URL  = "https://api.zenoid.space"
$env:ANTHROPIC_AUTH_TOKEN = "sk-zen-вставь-свой-ключ"
$env:ANTHROPIC_API_KEY    = "sk-zen-вставь-свой-ключ"
$env:ANTHROPIC_MODEL              = "claude-sonnet-4-7"
$env:ANTHROPIC_SMALL_FAST_MODEL   = "claude-haiku-4-7"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

claude @args

Если claude не находится — укажи полный путь, например & "$env:APPDATA\npm\claude.cmd" @args.

Прописать переменные в профиль PowerShell (постоянно, для текущего пользователя):

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.zenoid.space", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-zen-вставь-свой-ключ", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY",    "sk-zen-вставь-свой-ключ", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL",            "claude-sonnet-4-7", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "claude-haiku-4-7",  "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1",   "User")
# перезапусти терминал, потом просто:
claude

Сохрани как start-claude.sh, дай права chmod +x, запускай ./start-claude.sh.

#!/usr/bin/env bash
export ANTHROPIC_BASE_URL="https://api.zenoid.space"
export ANTHROPIC_AUTH_TOKEN="sk-zen-вставь-свой-ключ"
export ANTHROPIC_API_KEY="sk-zen-вставь-свой-ключ"
export ANTHROPIC_MODEL="claude-sonnet-4-7"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-7"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
exec claude "$@"

Альтернатива — добавь экспорты в ~/.bashrc / ~/.zshrc и просто запускай claude.

⚠ Нужна подписка Cursor Pro (≈ $20/мес). На Free / Hobby плане кастомный API-ключ и Override Base URL отключены: вкладка есть, но запросы всё равно идут через серверы Cursor. На Pro/Business — работает полноценный BYOK.

✓ Рекомендуемый способ — через OpenAI-секцию. Cursor валидирует имена моделей в Anthropic-секции по своему allowlist и может ругаться model name is not valid на -api-алиасы. OpenAI-секция этой проверки не делает — любые имена проходят.

В Cursor: Settings → Models → API Keys → OpenAI API Key.

Cmd/Ctrl + Shift + J → раздел Models
Секция API Keys → разверни OpenAI API Key
Вставь ключ, включи переключатель Override OpenAI Base URL:

OpenAI API Key:           sk-zen-вставь-свой-ключ
Override OpenAI Base URL: https://api.zenoid.space/v1

Model (Add model):  claude-sonnet-4-7-api
                    claude-opus-4-7-api

После Save нажми Verify — должен загореться зелёным. Затем добавь модели через Add model: claude-sonnet-4-7-api, claude-opus-4-7-api. Прокси сам сконвертит OpenAI-запрос в Anthropic под капотом.

⚠ Только Windsurf Enterprise / Teams Enterprise. На Free / Pro / Pro Ultimate провайдеры захардкожены в Cascade — кастомный Anthropic-endpoint недоступен. Если у тебя нет Enterprise — используй Cline / Roo Code / Continue прямо в VSCode-моде Windsurf'а (он же VSCode-fork, расширения работают).

На Enterprise — админ открывает Admin Console → Models и добавляет custom provider:

Provider type: OpenAI-compatible
Base URL:      https://api.zenoid.space/v1
API Key:       sk-zen-вставь-свой-ключ
Models:        claude-sonnet-4-7-api, claude-opus-4-7-api, claude-haiku-4-7-api

Обходной путь для не-Enterprise — поставить Cline или Roo Code как расширение внутри Windsurf (вкладка слева ниже) и пользоваться им вместо Cascade.

Aider — open-source CLI, читает ANTHROPIC_API_BASE и ANTHROPIC_API_KEY из окружения.

export ANTHROPIC_API_BASE="https://api.zenoid.space"
export ANTHROPIC_API_KEY="sk-zen-вставь-свой-ключ"

aider --model anthropic/claude-sonnet-4-7

Можно зафиксировать в ~/.aider.conf.yml:

model: anthropic/claude-sonnet-4-7
anthropic-api-base: https://api.zenoid.space
anthropic-api-key:  sk-zen-вставь-свой-ключ

✓ Полностью бесплатно. Расширения для VSCode (и его форков — Cursor, Windsurf, VSCodium). Roo Code — форк Cline, настраивается идентично.

Поставь Cline или Roo Code из Marketplace
Открой панель → иконка ⚙️ (Settings)
API Provider: OpenAI Compatible
Заполни поля:

API Provider: OpenAI Compatible
Base URL:     https://api.zenoid.space/v1
API Key:      sk-zen-вставь-свой-ключ
Model ID:     claude-sonnet-4-7-api

Доступные модели: claude-sonnet-4-7-api, claude-opus-4-7-api, claude-haiku-4-7-api. Прокси сам конвертит OpenAI ↔ Anthropic под капотом.

Zed бесплатный. Открой ~/.config/zed/settings.json (на маке — ~/.zed/settings.json):

{
  "language_models": {
    "anthropic": {
      "api_url": "https://api.zenoid.space",
      "available_models": [
        { "name": "claude-sonnet-4-7", "max_tokens": 200000 },
        { "name": "claude-haiku-4-7",  "max_tokens": 200000 }
      ]
    }
  },
  "agent": {
    "default_model": { "provider": "anthropic", "model": "claude-sonnet-4-7" },
    "version": "2"
  }
}

Затем cmd+shift+P → agent: authenticate (или assistant: authenticate на старых версиях) и вставь sk-zen-....

Open-source расширение для VSCode и JetBrains. Открой ~/.continue/config.yaml:

models:
  - name: Zenoid · Sonnet 4.7
    provider: anthropic
    model: claude-sonnet-4-7
    apiKey: sk-zen-вставь-свой-ключ
    apiBase: https://api.zenoid.space

  - name: Zenoid · Haiku 4.7
    provider: anthropic
    model: claude-haiku-4-7
    apiKey: sk-zen-вставь-свой-ключ
    apiBase: https://api.zenoid.space

OpenCode (sst/opencode) — open-source AI-агент в терминале, бесплатный. Подключаем как openai-compatible провайдера через config ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zenoid": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Zenoid",
      "options": {
        "baseURL": "https://api.zenoid.space/v1",
        "apiKey":  "sk-zen-вставь-свой-ключ"
      },
      "models": {
        "claude-sonnet-4-7-api": { "name": "Claude Sonnet 4.7" },
        "claude-opus-4-7-api":   { "name": "Claude Opus 4.7"   },
        "claude-haiku-4-7-api":  { "name": "Claude Haiku 4.7"  }
      }
    }
  },
  "model": "zenoid/claude-sonnet-4-7-api"
}

Альтернатива через env (если у тебя свежий opencode с поддержкой OPENAI_BASE_URL / OPENAI_API_KEY):

export OPENAI_BASE_URL="https://api.zenoid.space/v1"
export OPENAI_API_KEY="sk-zen-вставь-свой-ключ"

opencode

Goose от Block — open-source CLI/desktop агент. Бесплатный. Запуск через goose configure или напрямую через env:

export GOOSE_PROVIDER="anthropic"
export GOOSE_MODEL="claude-sonnet-4-7"
export ANTHROPIC_HOST="https://api.zenoid.space"
export ANTHROPIC_API_KEY="sk-zen-вставь-свой-ключ"

goose session

В desktop-версии: Settings → Providers → Anthropic → Host = https://api.zenoid.space.

Python (pip install anthropic):

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.zenoid.space",
    api_key="sk-zen-вставь-свой-ключ",
)

msg = client.messages.create(
    model="claude-sonnet-4-7",
    max_tokens=512,
    messages=[{"role": "user", "content": "hi"}],
)
print(msg.content[0].text)

Node (npm i @anthropic-ai/sdk):

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.zenoid.space",
  apiKey:  "sk-zen-вставь-свой-ключ",
});

const msg = await client.messages.create({
  model: "claude-sonnet-4-7",
  max_tokens: 512,
  messages: [{ role: "user", content: "hi" }],
});
console.log(msg.content[0].text);

Если приложение умеет только OpenAI-формат (Chat Completions), нужен мост. LiteLLM конвертирует OpenAI → Anthropic на лету.

# pip install litellm
import litellm

resp = litellm.completion(
    model="anthropic/claude-sonnet-4-7",
    api_base="https://api.zenoid.space",
    api_key="sk-zen-вставь-свой-ключ",
    messages=[{"role": "user", "content": "hi"}],
)
print(resp.choices[0].message.content)

Либо запусти LiteLLM как локальный OpenAI-совместимый сервер для любого приложения:

# pip install 'litellm[proxy]'
litellm \
  --model anthropic/claude-sonnet-4-7 \
  --api_base https://api.zenoid.space \
  --api_key  sk-zen-вставь-свой-ключ \
  --port 4000

# теперь любое OpenAI-SDK приложение:
#   OPENAI_API_BASE=http://localhost:4000
#   OPENAI_API_KEY=anything

Прямой Anthropic-вызов через прокси:

curl https://api.zenoid.space/v1/messages \
  -H "x-api-key: sk-zen-вставь-свой-ключ" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-7",
    "max_tokens": 256,
    "messages": [{"role":"user","content":"hi"}]
  }'