# Быстрый старт

> Создайте ключ, подключите инструмент и отправьте первый запрос за пару минут.

FreshRouter — это один API-ключ для множества ИИ-моделей. Он работает в форматах API OpenAI и Anthropic, поэтому большинство инструментов и SDK подключаются заменой двух настроек: base URL и ключа.

## 1. Создайте ключ

1. Зарегистрируйтесь и пополните баланс в консоли.
2. Откройте **Консоль → API-ключи** и нажмите **Создать ключ**.
3. Сразу скопируйте ключ. Он начинается с `sk-` и полностью показывается только один раз: если потеряете его, создайте новый.

## 2. Подключите инструмент

Окно с новым ключом сразу показывает, как им пользоваться, а раздел **Консоль → Подключение** показывает то же самое в любой момент. Ключ там уже везде подставлен, а модель выбирать не нужно.

Самый быстрый способ работает где угодно: вставьте один промпт в ИИ-агента, которым пользуетесь. Он подключит инструмент, в котором работает. Чтобы подключить что-то другое, допишите это после промпта: название инструмента или «этот проект».

```text title="Промпт"
Подключи мне FreshRouter. Это один API-ключ для Claude, GPT, Gemini, Grok, DeepSeek и других моделей, в форматах API OpenAI и Anthropic.

- Мой API-ключ: сначала спроси его у меня (он начинается с sk-) и подставляй ниже вместо <key>.
- Base URL, совместимый с OpenAI: https://freshrouter.com/v1 (chat completions и Responses API)
- Base URL, совместимый с Anthropic: https://freshrouter.com (без /v1 в конце; для моделей Claude)
- Все модели с ID, размером контекста и ценой: https://freshrouter.com/models.json (ключ не нужен)
- Инструкции по каждому инструменту, для агентов: https://freshrouter.com/ru/llms.txt

Что подключать: инструмент, в котором ты сейчас работаешь. Если после этого промпта я допишу что-то ещё — название другого инструмента или «этот проект», — подключи это.

1. У Claude Code, Codex, Grok Build и Pi есть установщики. Выполни команду для нужного инструмента, и больше ничего не требуется:
   Claude Code: curl -fsSL https://freshrouter.com/install/claude.sh | bash -s -- <key>
   Codex: curl -fsSL https://freshrouter.com/install/codex.sh | bash -s -- <key>
   Grok Build: curl -fsSL https://freshrouter.com/install/grok.js | node - <key>
   Pi: curl -fsSL https://freshrouter.com/install/pi.js | node - <key>
   В PowerShell на Windows:
   Claude Code: $env:FRESHROUTER_API_KEY="<key>"; irm https://freshrouter.com/install/claude.ps1 | iex
   Codex: $env:FRESHROUTER_API_KEY="<key>"; irm https://freshrouter.com/install/codex.ps1 | iex
   Grok Build: irm https://freshrouter.com/install/grok.js | node - <key>
   Pi: irm https://freshrouter.com/install/pi.js | node - <key>
   Каждая делает резервную копию файла, который меняет, и её безопасно запускать повторно.
2. Любой другой инструмент (Cursor, Cline, OpenCode, OpenClaw, Aider, Continue, Zed и так далее): добавь FreshRouter в настройки самого инструмента как собственного OpenAI-совместимого провайдера с base URL и ключом выше. Сначала посмотри в документации инструмента или в его --help, как это делается; не угадывай формат. Если инструменту нужен список моделей, возьми ID и размеры контекста из каталога моделей. Остальные настройки не трогай и делай резервную копию каждого файла, который меняешь. Если настроить можно только в приложении, скажи мне точно, что и куда вставить.
3. «Этот проект»: поменяй только base URL и ключ у SDK OpenAI или Anthropic, который уже есть в проекте, либо добавь официальный SDK OpenAI для языка проекта. Запиши ключ в файл .env проекта как FRESHROUTER_API_KEY, убедись, что .env указан в .gitignore, не прописывай ключ в коде и не коммить его. Вынеси ID модели в одну настройку.

Не спрашивай, какую модель выбрать: начни с claude-sonnet-5-5, а где подходят только модели OpenAI — с gpt-6.1-sol; я поменяю её позже. Когда закончишь, скажи, что ты изменил и как начать пользоваться. Для проекта ещё отправь один короткий тестовый запрос и покажи мне ответ.
```

Или выберите свой инструмент в консоли:

- **Claude Code, Codex, Pi, Grok Build:** инструмент настраивается одной командой в терминале.
- **Cursor, Cline, Roo Code, Kilo Code и другие приложения:** вставьте base URL и ключ в настройки инструмента.
- **Свой проект:** по промпту ИИ-агент подключит FreshRouter и отправит тестовый запрос; можно начать и с примера кода.

## 3. Или настройте вручную

| Формат | Base URL |
| --- | --- |
| Совместимый с OpenAI | `https://freshrouter.com/v1` |
| Совместимый с Anthropic | `https://freshrouter.com` |

Передавайте ключ в заголовке `Authorization: Bearer sk-…`. Клиенты Anthropic могут использовать и заголовок `x-api-key`.

## 4. Отправьте первый запрос

```bash
curl https://freshrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-freshrouter-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

> Названия моделей здесь — примеры. Точные ID всех моделей есть на странице цен (`https://freshrouter.com/pricing`), в `https://freshrouter.com/models.json` и на странице «Модели» в консоли.
