Пошаговая инструкция: как настроить бесплатный AI-агент

Понял. Вот полный текст статьи на русском, с исправленным абзацем про DeepSeek.

Title: Как подключить GigaChat к Skales без VPN: бесплатный AI-агент в России

Description: Пошаговая инструкция: как настроить бесплатный AI-агент на старом Mac без VPN. GigaChat API, gpt2giga, Skales. Все ошибки и решения.

Keywords: бесплатный AI агент, GigaChat API, Skales, gpt2giga, без VPN, инструкция для новичка, Mac Pro 2008

Современный маркетолог — это художник. У него есть палитра, кисти и холст. Только вместо красок — API, вместо кистей — терминал, а вместо холста — агент, который выполняет рутину за тебя. Проблема в том, что большинство «красок» в России недоступны без VPN и иностранных карт. Но есть путь.

Я прошёл его на старом Mac Pro 2008 года. Рассказываю пошагово, с ошибками и решениями.

Что понадобится

Mac (подойдёт даже старый, 2008 года — я проверял)
Терминал — встроен в macOS
GigaChat API — бесплатный доступ от Сбера, 365 млн токенов на год для физлиц
Skales — AI-агент, который умеет читать файлы, искать в интернете и выполнять задачи
gpt2giga — прокси-сервер, который превращает GigaChat API в формат OpenAI

Шаг 1. Получаем ключ GigaChat

Заходим на developers.sber.ru.
Регистрируемся через Сбер ID (нужен российский номер телефона).
Создаём проект GigaChat API.
Нажимаем «Сгенерировать новый Client Secret».
Копируем ключ — он показывается только один раз.

Ключ выглядит как длинная строка из букв и цифр, заканчивается на ==. Это Authorization key, а не токен. Его нужно передавать в заголовке Authorization: Basic <ключ>.

Шаг 2. Устанавливаем uv и gpt2giga

Открываем Терминал и выполняем:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uv --version
uv tool install gpt2giga

uv — это менеджер пакетов Python. gpt2giga установится в изолированное окружение и не будет мешать другим программам.

Шаг 3. Создаём рабочую папку и файл с ключом

mkdir -p ~/gigachat_api
cd ~/gigachat_api
nano .env

Вставляем в .env:

GIGACHAT_CREDENTIALS=ТВОЙ_КЛЮЧ_ОТ_СБЕРА
GIGACHAT_SCOPE=GIGACHAT_API_PERS
GIGACHAT_VERIFY_SSL_CERTS=False

Сохраняем: Ctrl+O → Enter → Ctrl+X.

Шаг 4. Создаём файл запуска

nano start_gigachat.command

Вставляем:

#!/bin/bash
cd "$(dirname "$0")"
echo "Запуск прокси-сервера GigaChat..."
echo "Адрес для Skales: http://localhost:8090/v1"
echo "Не закрывайте это окно, пока работаете в Skales."
echo "----------------------------------------"
gpt2giga --env-path .env --proxy.pass-token True --gigachat.scope GIGACHAT_API_PERS --gigachat.verify-ssl-certs False

Сохраняем и делаем исполняемым:

chmod +x start_gigachat.command

Шаг 5. Запускаем и проверяем

./start_gigachat.command

Должно появиться:

INFO:     Uvicorn running on http://localhost:8090

Не закрываем это окно. Открываем второе окно Терминала (Cmd+N) и проверяем:

curl -H "Authorization: Bearer giga-cred-ТВОЙ_КЛЮЧ:GIGACHAT_API_PERS" http://localhost:8090/v1/models

Если вернулся список моделей (GigaChat-2, GigaChat-3-Pro и т.д.) — всё работает.

Шаг 6. Настраиваем Skales

Открываем Skales → Настройки → Провайдеры → Добавить.
Выбираем Custom (OpenAI-compatible).
Заполняем:
- URL ENDPOINT: http://localhost:8090/v1
- МОДЕЛЬ: GigaChat-3-Pro (или другую из списка)
- ПРОТОКОЛ: OpenAI Chat Completions
- API КЛЮЧ: giga-cred-ТВОЙ_КЛЮЧ:GIGACHAT_API_PERS
- Работает локально: ВКЛ
Нажимаем «Получить доступные модели» — должно появиться 10 моделей.
Нажимаем «Установить активным».
Создаём новый чат и пишем «Привет!» — GigaChat отвечает.

С чем я столкнулся (и как решал)

Ошибка	Причина	Решение
401 Unauthorized	Ключ не принимался	Перевыпустить ключ на developers.sber.ru
400 Can’t decode ‘Authorization’ header	Ключ передавался без Basic-обёртки	Использовать формат `giga-cred-...:GIGACHAT_API_PERS`
400 Invalid GigaChat pass-through token	Skales отправлял ключ не в том формате	Включить `--proxy.pass-token True`
CERTIFICATE_VERIFY_FAILED	Сертификат Минцифры не подхватывался	Добавить `--gigachat.verify-ssl-certs False`

Что в итоге

Агент в Skales видит папку на внешнем диске.
Читает, создаёт и изменяет файлы.
Можно переключаться между моделями GigaChat прямо в интерфейсе: Lite для простых задач, Pro для сложных.
Всё бесплатно в рамках годового лимита — 365 млн токенов.

Про DeepSeek и другие альтернативы

Если GigaChat по каким-то причинам не подойдёт, есть DeepSeek. Его API тоже работает из России без VPN, но важно: бесплатных токенов при регистрации нет. Чтобы начать пользоваться, нужно пополнить баланс.

Однако цены у DeepSeek очень низкие. Например, модель deepseek-v4-flash в непиковые часы стоит примерно $0.22 за миллион входных токенов и $0.66 за миллион выходных. Для личных проектов и обучения этого хватит надолго — пара долларов покрывает месяцы использования.

Настроить DeepSeek в Skales можно так же, как GigaChat, но без прокси gpt2giga — DeepSeek уже OpenAI-совместим. Нужно только указать https://api.deepseek.com в качестве Base URL и вставить API-ключ.

Про Сбер

Отдельно хочу похвалить Сбер за то, что они сделали:

Бесплатный доступ к мощным моделям для физлиц.
Понятную документацию.
OpenAI-совместимый API — это сильно упрощает интеграцию.

Да, были нюансы с gpt2giga, но это сторонний инструмент, и он решаемый.

Современный маркетолог — это художник

Инструментарий современного художника

Как «взломать» Алису или DeepSeek

Метод синестезии Артемьева: как взломать Алису

Как подключить GigaChat к Skales без VPN: бесплатный AI-агент в России