OrProject API Documentation
Complete guide to using the OrProject API service — a fully compatible Anthropic Claude API.
Quick Start
The OrProject API is fully compatible with Anthropic's Messages API. Simply replace the base URL and use your OrProject API key.
Base URL: https://orproject.online/v1
Authentication
Include your API key in the x-api-key header or as Authorization: Bearer sk-ant-...
curl https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-YOUR_KEY_HERE" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude!"}]
}'
Supported Models
| Model ID |
Provider |
Tier |
Input $/1M tokens |
Output $/1M tokens |
claude-opus-4-8 | Anthropic | Complex reasoning | $15.00 | $75.00 |
claude-opus-4-7 | Anthropic | Complex reasoning | $15.00 | $75.00 |
claude-opus-4-6 | Anthropic | Complex reasoning | $15.00 | $75.00 |
claude-opus-4-5 | Anthropic | Complex reasoning | $15.00 | $75.00 |
claude-sonnet-4-6 | Anthropic | Balanced performance | $3.00 | $15.00 |
claude-sonnet-4-5 | Anthropic | Balanced performance | $3.00 | $15.00 |
claude-haiku-4-5 | Anthropic | Speed-optimized | $0.80 | $4.00 |
fable | Anthropic | Temporarily unavailable | — | — |
API Endpoints
Messages API (Anthropic-compatible)
POST
/v1/messages
Create a message using the Anthropic Messages API format. Supports streaming, tool use, and all standard parameters.
{
"model": "claude-sonnet-4-5",
"max_tokens": 4096,
"messages": [
{"role": "user", "content": "Explain quantum computing"}
],
"stream": false
}
Streaming
Set "stream": true to receive Server-Sent Events (SSE). The response follows Anthropic's streaming format:
event: message_start
data: {"type":"message_start","message":{...}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Hello"}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":15}}
event: message_stop
data: {"type":"message_stop"}
Tool Use
Full tool use support. Define tools in your request:
{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"tools": [
{
"name": "get_weather",
"description": "Get current weather",
"input_schema": {
"type": "object",
"properties": {
"location": {"type": "string", "description": "City name"}
},
"required": ["location"]
}
}
],
"messages": [{"role": "user", "content": "What's the weather in Paris?"}]
}
Chat Completions (OpenAI-compatible)
POST
/v1/chat/completions
OpenAI-compatible endpoint for tools like OpenCode, Codex, OpenClaw, and IDE integrations.
curl https://orproject.online/v1/chat/completions \
-H "Authorization: Bearer sk-ant-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"messages": [{"role": "user", "content": "Hello!"}],
"max_tokens": 1024
}'
List Models
GET
/v1/models
Returns all available models.
Backend & Memory
OrProject is a thin Anthropic-compatible front for a Provider instance that itself rotates a pool of Claude Web accounts.
- Conversation memory — the full
messages array you send is forwarded as-is, so the model sees every previous turn.
- Account rotation — managed in the admin panel.
- Backend mode — switch between
provider and legacy without restarting.
Setting Environment Variables
Most clients (Claude Code, OpenCode, Codex CLI, Aider, custom scripts) read the API key and base URL from environment variables. Pick the snippet for your operating system and shell.
macOS & Linux (bash / zsh)
For a one-off session, just paste this into your terminal:
export ANTHROPIC_BASE_URL=https://orproject.online
export ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
# Some clients also expect the OpenAI variables:
export OPENAI_BASE_URL=https://orproject.online/v1
export OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
To make it permanent, append the same lines to your shell profile (~/.zshrc on modern macOS, ~/.bashrc or ~/.bash_profile on Linux), then run source ~/.zshrc (or open a new terminal).
Windows — PowerShell (recommended)
Per-session (variables disappear when the shell closes):
$env:ANTHROPIC_BASE_URL = "https://orproject.online"
$env:ANTHROPIC_API_KEY = "sk-ant-YOUR_KEY_HERE"
$env:OPENAI_BASE_URL = "https://orproject.online/v1"
$env:OPENAI_API_KEY = "sk-ant-YOUR_KEY_HERE"
Permanent (saved into your Windows user profile, applies to every new shell):
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://orproject.online", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-YOUR_KEY_HERE", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://orproject.online/v1", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-ant-YOUR_KEY_HERE", "User")
Close the PowerShell window and open a new one — the new variables are now visible to every CLI/IDE.
Windows — CMD (cmd.exe)
Per-session:
set ANTHROPIC_BASE_URL=https://orproject.online
set ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
set OPENAI_BASE_URL=https://orproject.online/v1
set OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
Permanent (saves to the user environment):
setx ANTHROPIC_BASE_URL "https://orproject.online"
setx ANTHROPIC_API_KEY "sk-ant-YOUR_KEY_HERE"
setx OPENAI_BASE_URL "https://orproject.online/v1"
setx OPENAI_API_KEY "sk-ant-YOUR_KEY_HERE"
Open a fresh CMD window after running setx — the variables are not visible in the current one.
Windows — GUI (Settings → Environment Variables)
- Press
Win + R, type sysdm.cpl, press Enter.
- Go to the Advanced tab → Environment Variables…
- Under User variables, click New… and add:
ANTHROPIC_BASE_URL = https://orproject.online
ANTHROPIC_API_KEY = your sk-ant-… key
OPENAI_BASE_URL = https://orproject.online/v1
OPENAI_API_KEY = your sk-ant-… key
- Click OK twice and restart your terminal / IDE.
Docker / docker-compose
services:
claude-code:
image: your-image
environment:
ANTHROPIC_BASE_URL: https://orproject.online
ANTHROPIC_API_KEY: sk-ant-YOUR_KEY_HERE
OPENAI_BASE_URL: https://orproject.online/v1
OPENAI_API_KEY: sk-ant-YOUR_KEY_HERE
systemd unit (Linux server)
[Service]
Environment=ANTHROPIC_BASE_URL=https://orproject.online
Environment=ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
Environment=OPENAI_BASE_URL=https://orproject.online/v1
Environment=OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
.env file (Node / Python projects)
# project root, loaded via dotenv
ANTHROPIC_BASE_URL=https://orproject.online
ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
OPENAI_BASE_URL=https://orproject.online/v1
OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
Integration Guides
/app → Settings → API keys). The base URL is the OrProject host (the same one you used to load this page)." data-ru="Во всех IDE-плагинах ниже API key — это sk-ant-... токен из настроек вашего аккаунта (войдите на /app → Настройки → API-ключи). Base URL — хост OrProject (тот же, с которого вы открыли эту страницу).">Your API key is the sk-ant-... token from your account settings at /app. The base URL is the OrProject host.
Claude Code
Configure Claude Code to use the OrProject API:
# Set the API base URL and key
export ANTHROPIC_BASE_URL=https://orproject.online/v1
export ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
# Launch Claude Code
claude
Or in your Claude Code config file (~/.claude/settings.json):
{
"env": {
"ANTHROPIC_BASE_URL": "https://orproject.online/v1",
"ANTHROPIC_API_KEY": "sk-ant-YOUR_KEY_HERE"
}
}
OpenCode
# Environment variables
export ANTHROPIC_BASE_URL=https://orproject.online/v1
export ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
# Or for OpenAI-compatible mode
export OPENAI_BASE_URL=https://orproject.online/v1
export OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
Codex CLI
# Configure Codex to use OrProject
export OPENAI_BASE_URL=https://orproject.online/v1
export OPENAI_API_KEY=sk-ant-YOUR_KEY_HERE
OpenClaw
# Set in your .env or shell
ANTHROPIC_BASE_URL=https://orproject.online/v1
ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
Cline (VS Code)
In Cline's settings, choose Anthropic as the provider, then:
API Key: sk-ant-YOUR_KEY_HERE
Custom Base URL / API URL: https://orproject.online
Model: any Claude name — internally routed to claude-v4-pro.
Continue.dev (VS Code & JetBrains)
Edit ~/.continue/config.json:
{
"models": [
{
"title": "OrProject — Claude v4 Pro",
"provider": "anthropic",
"model": "claude-sonnet-4-5",
"apiKey": "sk-ant-YOUR_KEY_HERE",
"apiBase": "https://orproject.online"
}
]
}
Roo Code / Cursor / generic Anthropic clients
ANTHROPIC_BASE_URL=https://orproject.online
ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
Generic IDE Integration
For any plugin that supports a custom Anthropic-style endpoint:
- Open extension settings
- Set API Base URL to
https://orproject.online/v1
- Set API Key to your
sk-ant-... key
- Select any Claude model
cURL Test
# Non-streaming test
curl -X POST https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-YOUR_KEY" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [{"role":"user","content":"Say hello and tell me who you are."}]
}'
# Streaming test
curl -X POST https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-YOUR_KEY" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"stream": true,
"messages": [{"role":"user","content":"Tell me a short joke."}]
}'
VS Code: step-by-step setup
The following walkthroughs were captured against this same OrProject deployment. The plugin GUIs change occasionally — fields stay the same, just the layout drifts.
Cline (recommended for code-editing tasks)
- Install Cline from the VS Code marketplace (publisher:
saoudrizwan).
- Open the Cline sidebar and click the gear icon to enter settings.
- Set API Provider =
Anthropic.
- Set API Key = your
sk-ant-... from your account settings at /app.
- Set Custom Base URL =
https://orproject.online (Cline appends /v1 internally).
- Pick any Claude-family model in the model dropdown.
- Click Done, then ask Cline to read or write a file in your workspace.
Cline's API Provider settings — Anthropic + custom base URL pointing to OrProject:

Real Cline run through OrProject — read a Python file, then write a new utils.py:


Claude Code CLI (terminal)
Anthropic's official Claude Code CLI works through OrProject as long as you point its ANTHROPIC_BASE_URL at us. The CLI manages conversation history itself, so multi-turn dialogues "just work".
# macOS / Linux
export ANTHROPIC_BASE_URL=https://orproject.online
export ANTHROPIC_API_KEY=sk-ant-YOUR_KEY_HERE
claude # opens an interactive Claude Code session
Or persist it for VS Code's integrated terminal by writing to ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://orproject.online",
"ANTHROPIC_API_KEY": "sk-ant-YOUR_KEY_HERE"
}
}
Continue.dev (VS Code & JetBrains)
- Install Continue from the marketplace.
- Open
~/.continue/config.json and add a model entry pointing at OrProject:
{
"models": [
{
"title": "OrProject — Claude (Claude backend)",
"provider": "anthropic",
"model": "claude-sonnet-4-5",
"apiKey": "sk-ant-YOUR_KEY_HERE",
"apiBase": "https://orproject.online"
}
]
}
After saving, Continue picks up the model immediately — open the chat panel, select the model, and chat normally. Continue manages its own conversation thread per chat tab.
Conversation memory & tool loops
OrProject is a stateless proxy — it does not keep its own copy of your dialogue. Each request must contain the full message history; whatever the IDE plugin sends is what the model sees.
- Cline / Claude Code / Continue all manage history client-side. As long as you don't restart the IDE or close the chat, the history is preserved.
- If you're calling the API yourself (curl / SDK), append every previous
user and assistant message — including tool_use and tool_result blocks — to messages on each new turn.
- OrProject mirrors past
tool_use calls into the visible assistant text ([tool_call: name(args)]) before forwarding to the Claude backend, so the model can see which tools it already invoked and stops re-calling them in a loop.
- If the model still loops on a specific tool, lower its
max_tokens or reduce the number of tools you pass — large tool catalogs increase the chance of drift.
Usage Tracking
View your API usage and remaining budget at /usage. Enter your API key to see:
- Total tokens used
- Remaining quota (tokens)
- Total requests count
- Detailed request logs with timestamps, models, and token counts
Rate Limits & Budgets
Each API key has a budget (set by admin). When the budget is exhausted, requests will return a 429 error. Contact your administrator to increase the budget.
Error Handling
Errors follow the Anthropic error format:
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "Invalid API key."
}
}
| Status | Type | Description |
| 401 | authentication_error | Invalid or missing API key |
| 403 | permission_error | API key disabled |
| 429 | rate_limit_error | Budget exceeded |
| 500 | api_error | Internal server error |
Документация OrProject API
Полное руководство по использованию OrProject API — полностью совместимого Anthropic Claude API.
Быстрый старт
OrProject API полностью совместим с Anthropic Messages API. Просто замените базовый URL и используйте ваш API ключ OrProject.
Базовый URL: https://orproject.online/v1
Аутентификация
Добавьте API ключ в заголовок x-api-key или как Authorization: Bearer sk-ant-...
curl https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-ВАШ_КЛЮЧ" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Привет, Claude!"}]
}'
Поддерживаемые модели
| ID модели |
Провайдер |
Уровень |
claude-fable-5 | Anthropic | Сверхсложные агентные системы, автономное долгосрочное планирование на недели, креативный синтез знаний из миллионов источников, мультимодальный анализ огромных корпусов данных, генерация полноценных исследовательских проектов |
claude-opus-4-8 | Anthropic | Сверхсложные задачи: многоагентное взаимодействие, глубокий кодинг с самопроверкой и итеративным улучшением, адаптивное мышление в условиях высокой неопределённости |
claude-opus-4-7 | Anthropic | Сложные задачи: высокоточное компьютерное зрение, долгосрочные автономные агенты, сложный многошаговый анализ и синтез информации |
claude-opus-4-6 | Anthropic | Сложные задачи: автономное решение инженерных проблем, генерация и отладка больших сложных систем |
claude-opus-4-5 | Anthropic | Сложные задачи: глубокий исследовательский анализ, сложные симуляции и моделирование |
claude-sonnet-4-6 | Anthropic | Баланс: сложный кодинг, производство кода, многошаговое рассуждение в реальном времени |
claude-sonnet-4-5 | Anthropic | Баланс: продвинутые задачи с хорошим соотношением скорости и интеллекта |
claude-haiku-4-5 | Anthropic | Быстрые задачи: высокопроизводительные сложные запросы с минимальной задержкой |
API Эндпоинты
Messages API (совместим с Anthropic)
POST
/v1/messages
Создание сообщения в формате Anthropic Messages API. Поддержка стриминга, инструментов и всех стандартных параметров.
Chat Completions (совместим с OpenAI)
POST
/v1/chat/completions
OpenAI-совместимый эндпоинт для OpenCode, Codex, OpenClaw и IDE.
Список моделей
GET
/v1/models
Возвращает все доступные модели.
Установка переменных окружения
Большинство клиентов (Claude Code, OpenCode, Codex CLI, Aider, кастомные скрипты) читают ключ и базовый URL из переменных окружения. Выберите сниппет под вашу ОС и оболочку.
macOS и Linux (bash / zsh)
Разово в текущей сессии:
export ANTHROPIC_BASE_URL=https://orproject.online
export ANTHROPIC_API_KEY=sk-ant-ВАШ_КЛЮЧ
# Некоторые клиенты ждут переменные OpenAI:
export OPENAI_BASE_URL=https://orproject.online/v1
export OPENAI_API_KEY=sk-ant-ВАШ_КЛЮЧ
Чтобы переменные применялись всегда, допишите эти же строки в профиль оболочки (~/.zshrc на macOS, ~/.bashrc или ~/.bash_profile на Linux) и выполните source ~/.zshrc (или просто откройте новый терминал).
Windows — PowerShell (рекомендуется)
На текущую сессию (исчезнут с закрытием окна):
$env:ANTHROPIC_BASE_URL = "https://orproject.online"
$env:ANTHROPIC_API_KEY = "sk-ant-ВАШ_КЛЮЧ"
$env:OPENAI_BASE_URL = "https://orproject.online/v1"
$env:OPENAI_API_KEY = "sk-ant-ВАШ_КЛЮЧ"
Постоянно (сохраняется в профиле пользователя Windows и подхватывается всеми новыми оболочками/IDE):
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://orproject.online", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-ВАШ_КЛЮЧ", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://orproject.online/v1", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-ant-ВАШ_КЛЮЧ", "User")
Закройте текущее окно PowerShell и откройте новое — переменные станут доступны во всех IDE и CLI.
Windows — CMD (cmd.exe)
Разово:
set ANTHROPIC_BASE_URL=https://orproject.online
set ANTHROPIC_API_KEY=sk-ant-ВАШ_КЛЮЧ
set OPENAI_BASE_URL=https://orproject.online/v1
set OPENAI_API_KEY=sk-ant-ВАШ_КЛЮЧ
Постоянно (сохраняет в пользовательское окружение):
setx ANTHROPIC_BASE_URL "https://orproject.online"
setx ANTHROPIC_API_KEY "sk-ant-ВАШ_КЛЮЧ"
setx OPENAI_BASE_URL "https://orproject.online/v1"
setx OPENAI_API_KEY "sk-ant-ВАШ_КЛЮЧ"
После setx откройте свежий CMD — в текущем переменные не появятся.
Windows — через GUI (Параметры → Переменные среды)
- Нажмите
Win + R, введите sysdm.cpl, Enter.
- Вкладка Дополнительно → Переменные среды…
- В разделе Переменные среды пользователя нажмите Создать… и добавьте:
ANTHROPIC_BASE_URL = https://orproject.online
ANTHROPIC_API_KEY = ваш sk-ant-… ключ
OPENAI_BASE_URL = https://orproject.online/v1
OPENAI_API_KEY = ваш sk-ant-… ключ
- Нажмите OK два раза и перезапустите терминал / IDE.
Docker / docker-compose
services:
claude-code:
image: your-image
environment:
ANTHROPIC_BASE_URL: https://orproject.online
ANTHROPIC_API_KEY: sk-ant-ВАШ_КЛЮЧ
OPENAI_BASE_URL: https://orproject.online/v1
OPENAI_API_KEY: sk-ant-ВАШ_КЛЮЧ
systemd unit (Linux-сервер)
[Service]
Environment=ANTHROPIC_BASE_URL=https://orproject.online
Environment=ANTHROPIC_API_KEY=sk-ant-ВАШ_КЛЮЧ
Environment=OPENAI_BASE_URL=https://orproject.online/v1
Environment=OPENAI_API_KEY=sk-ant-ВАШ_КЛЮЧ
.env файл (Node / Python проекты)
# корень проекта, грузится через dotenv
ANTHROPIC_BASE_URL=https://orproject.online
ANTHROPIC_API_KEY=sk-ant-ВАШ_КЛЮЧ
OPENAI_BASE_URL=https://orproject.online/v1
OPENAI_API_KEY=sk-ant-ВАШ_КЛЮЧ
Инструкции по интеграции
Claude Code (рекомендуется)
Установите переменные окружения по разделу выше — на любой ОС, — затем запустите:
claude
Или прямо в конфиге Claude Code (~/.claude/settings.json на macOS/Linux, %USERPROFILE%\.claude\settings.json на Windows):
{
"env": {
"ANTHROPIC_BASE_URL": "https://orproject.online",
"ANTHROPIC_API_KEY": "sk-ant-ВАШ_КЛЮЧ"
}
}
OpenCode / OpenClaw
Используют те же переменные ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY. Если плагин ждёт OpenAI-формат, выставьте также OPENAI_BASE_URL=https://orproject.online/v1 и OPENAI_API_KEY=sk-ant-….
Codex CLI (OpenAI-совместимый)
Только OpenAI-переменные:
export OPENAI_BASE_URL=https://orproject.online/v1
export OPENAI_API_KEY=sk-ant-ВАШ_КЛЮЧ
codex
Cline (VS Code)
- В сайдбаре Cline → шестерёнка → API Provider выберите Anthropic.
API Key: sk-ant-ВАШ_КЛЮЧ
Custom Base URL / API URL: https://orproject.online
Model: любой Claude (всё равно роутится в claude-v4-pro).
Continue.dev (VS Code и JetBrains)
Откройте ~/.continue/config.json (на Windows: %USERPROFILE%\.continue\config.json) и добавьте:
{
"models": [
{
"title": "OrProject — Claude v4 Pro",
"provider": "anthropic",
"model": "claude-sonnet-4-5",
"apiKey": "sk-ant-ВАШ_КЛЮЧ",
"apiBase": "https://orproject.online"
}
]
}
Cursor / Roo Code / другие Anthropic-клиенты
В настройках укажите:
- Anthropic Base URL или Custom API endpoint:
https://orproject.online (или https://orproject.online/v1, если плагин не дописывает /v1 сам).
- API Key:
sk-ant-ВАШ_КЛЮЧ
- Model: любая Claude (Opus / Sonnet / Haiku) — все три уровня обслуживаются одной моделью Claude.
Тест через cURL
# Без стрима
curl -X POST https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-ВАШ_КЛЮЧ" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [{"role":"user","content":"Привет, представься."}]
}'
# Со стримом
curl -X POST https://orproject.online/v1/messages \
-H "x-api-key: sk-ant-ВАШ_КЛЮЧ" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"stream": true,
"messages": [{"role":"user","content":"Расскажи короткую шутку."}]
}'
Память диалога / продолжение чата
OrProject не хранит сессии на сервере. Чтобы Claude помнил, о чём вы говорили, ваш клиент (Claude Code, Cline, Continue, ваш скрипт) должен в каждом запросе слать весь массив messages — все предыдущие сообщения от user и assistant. Если вы просто шлёте новое сообщение без истории, ассистент увидит его как первое.
Все упомянутые выше IDE-плагины делают это автоматически — память «живёт» ровно столько, сколько открыта вкладка/чат в IDE.
Пошаговая настройка в VS Code (со скринами)
Скрины ниже сняты на этом же деплое OrProject. Интерфейс плагинов иногда меняется, но поля те же.
Cline (рекомендуется для правки кода)
- Установи Cline из VS Code Marketplace (издатель:
saoudrizwan).
- Открой сайдбар Cline и нажми шестерёнку для входа в настройки.
- Выбери API Provider =
Anthropic.
- API Key = твой
sk-ant-... из настроек аккаунта /app.
- Custom Base URL =
https://orproject.online (Cline сам добавит /v1).
- В выпадающем списке моделей выбери любую Claude.
- Жми Done и попроси Cline прочитать или записать файл в открытом проекте.
Настройки Cline — Anthropic + Custom Base URL на OrProject:

Реальный прогон: Cline через OrProject читает Python-файл и пишет новый utils.py:


Claude Code CLI (терминал)
Официальная утилита Anthropic Claude Code работает через OrProject — достаточно указать ANTHROPIC_BASE_URL. Утилита сама хранит историю диалога, поэтому многоходовые разговоры идут «из коробки».
# macOS / Linux
export ANTHROPIC_BASE_URL=https://orproject.online
export ANTHROPIC_API_KEY=sk-ant-ТВОЙ_КЛЮЧ
claude # запустит интерактивную сессию Claude Code
Чтобы это срабатывало в встроенном терминале VS Code, пропиши в ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://orproject.online",
"ANTHROPIC_API_KEY": "sk-ant-ТВОЙ_КЛЮЧ"
}
}
Continue.dev (VS Code и JetBrains)
- Установи Continue из Marketplace.
- Открой
~/.continue/config.json и добавь модель, указывающую на OrProject:
{
"models": [
{
"title": "OrProject — Claude (Claude)",
"provider": "anthropic",
"model": "claude-sonnet-4-5",
"apiKey": "sk-ant-ТВОЙ_КЛЮЧ",
"apiBase": "https://orproject.online"
}
]
}
После сохранения Continue подхватывает модель сразу — открой панель чата, выбери модель, общайся как обычно. Continue сам ведёт историю по каждой вкладке чата.
Память диалога и зацикливание тулзов
OrProject — stateless-прокси. Сервер не хранит твою переписку: каждый запрос обязан содержать весь массив messages. Что плагин прислал — то модель и видит.
- Cline / Claude Code / Continue хранят историю на стороне клиента. Пока ты не перезапустил IDE и не закрыл чат — память жива.
- Если работаешь голым curl/SDK — добавляй каждый предыдущий
user и assistant (включая блоки tool_use и tool_result) в массив messages на каждом ходу.
- OrProject дублирует прошлые
tool_use в видимый текст ассистента ([tool_call: name(args)]) перед отправкой в Claude-бэкенд — модель видит, какие тулзы она уже вызывала, и не зацикливается.
- Если модель всё ещё зацикливается — снизь
max_tokens или сократи список тулзов в запросе. Большие каталоги тулзов чаще сбивают её с курса.
Отслеживание расхода
Просмотр использования API и оставшегося бюджета: /usage. Введите API ключ чтобы увидеть:
- Общее количество использованных токенов
- Остаток квоты (в токенах)
- Количество запросов
- Детальные логи с временными метками, моделями и количеством токенов
Лимиты и бюджеты
Каждый API ключ имеет бюджет (установлен админом). Когда бюджет исчерпан, запросы вернут ошибку 429. Свяжитесь с администратором для увеличения бюджета.
Обработка ошибок
Ошибки следуют формату Anthropic:
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "Invalid API key."
}
}
| Статус | Тип | Описание |
| 401 | authentication_error | Неверный или отсутствующий API ключ |
| 403 | permission_error | API ключ отключён |
| 429 | rate_limit_error | Бюджет исчерпан |
| 500 | api_error | Внутренняя ошибка сервера |