Теги: claude, ai-tools, devtools, llm, tutorial

Claude Code — это CLI-агент от Anthropic, который работает прямо в терминале: читает код, редактирует файлы, запускает команды и работает с git. Официально требует подписку Anthropic ($20+/мес) или API-ключ с оплатой по токенам.

В этой статье — способ запустить его бесплатно через Kiro AI (AWS), используя OmniRoute как локальный прокси-адаптер.

Дисклеймер: Kiro AI имеет бесплатный тир с лимитами на токены. Убедитесь, что использование API через сторонние прокси соответствует Terms of Service Kiro AI перед применением в коммерческих проектах.

Как это работает

Claude Code (CLI) → OmniRoute (localhost:20128) → Kiro AI (AWS) → claude-sonnet-4.5

OmniRoute — локальный прокси-сервер, который перехватывает запросы от Claude Code (стандартный формат Anthropic API) и транслирует их в формат Kiro AI, где доступен бесплатный Claude Sonnet 4.5.

Шаг 1. Установка Node.js (один раз)

Требуется версия v18–v22 (LTS):

node --version  # должно быть v18.x / v20.x / v22.x
npm --version

Скачать: nodejs.org → LTS.

Windows: после установки перезапустите CMD/PowerShell.

Шаг 2. Установка и запуск OmniRoute (один раз)

# Обязательно @latest — иначе может установиться старая версия
# с ошибкой "better_sqlite3.node is not valid Win32 application"
npm install -g omniroute@latest

# Запуск
omniroute

После запуска автоматически откроется браузер с интерфейсом OmniRoute. При первом входе система попросит придумать пароль — это локальная аутентификация интерфейса, не путайте с API-ключом.

Важно: терминал с omniroute должен оставаться открытым всё время работы. Запомните порт (по умолчанию 20128) — он отображается в терминале.

Шаг 3. Получение API-ключа Kiro AI

В интерфейсе OmniRoute перейдите: Providers → Kiro AI.

1. Нажмите "Создать аккаунт" (вход через Google / AWS Builder ID)
2. Нажмите Create API Key
3. Скопируйте ключ вида sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ключ отображается только один раз — сохраните его сразу.

Шаг 4. Установка Claude Code (один раз)

Способ 1 — нативный инсталлер (рекомендуется):

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

Способ 2 — через npm:

npm install -g @anthropic-ai/claude-code
claude --version  # проверка: claude 1.x.x

Шаг 5. Настройка переменных окружения

Нужно направить Claude Code через OmniRoute вместо серверов Anthropic.

macOS / Linux — добавьте в ~/.bashrc или ~/.zshrc:

# OmniRoute + Kiro AI для Claude Code
export ANTHROPIC_BASE_URL="http://localhost:20128/v1"
export ANTHROPIC_AUTH_TOKEN="ваш-kiro-api-key"
export ANTHROPIC_API_KEY=""  # пустая строка — обязательно!
export ANTHROPIC_MODEL="kr/claude-sonnet-4.5"
export ANTHROPIC_SMALL_FAST_MODEL="kr/claude-sonnet-4.5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

source ~/.bashrc  # применить изменения

Windows (PowerShell) — временно на сессию:

$env:ANTHROPIC_BASE_URL = "http://localhost:20128/v1"
$env:ANTHROPIC_AUTH_TOKEN = "ваш-kiro-api-key"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_MODEL = "kr/claude-sonnet-4.5"
$env:ANTHROPIC_SMALL_FAST_MODEL = "kr/claude-sonnet-4.5"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

ANTHROPIC_API_KEY="" — пустая строка обязательна. Без неё Claude Code попытается авторизоваться напрямую через Anthropic и выдаст ошибку. Если OmniRoute запустился на другом порту — замените 20128 на свой.

Шаг 6. Запуск

cd ~/projects/ваш-проект
claude

Полезные команды внутри Claude Code

Команда

Описание

/cost

Токены, потраченные за сессию

/model

Текущая модель

/clear

Очистить контекст

Ctrl+C / exit

Выйти

Удобный алиас (чтобы не вводить переменные каждый раз)

macOS / Linux — добавьте в ~/.bashrc / ~/.zshrc:

alias cc='ANTHROPIC_BASE_URL="http://localhost:20128/v1" \
  ANTHROPIC_AUTH_TOKEN="ваш-kiro-api-key" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_MODEL="kr/claude-sonnet-4.5" \
  ANTHROPIC_SMALL_FAST_MODEL="kr/claude-sonnet-4.5" \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude'

Windows — создайте C:\scripts\cc.bat:

@echo off
set ANTHROPIC_BASE_URL=http://localhost:20128/v1
set ANTHROPIC_AUTH_TOKEN=ваш-kiro-api-key
set ANTHROPIC_API_KEY=
set ANTHROPIC_MODEL=kr/claude-sonnet-4.5
set ANTHROPIC_SMALL_FAST_MODEL=kr/claude-sonnet-4.5
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude %*

Добавьте C:\scripts в системный PATH: Пуск → "переменные среды" → Path → Изменить → Добавить.

Переключение между режимами (если есть подписка Anthropic)

# ~/.bashrc / ~/.zshrc

# Бесплатно через Kiro AI
alias cc='ANTHROPIC_BASE_URL="http://localhost:20128/v1" \
  ANTHROPIC_AUTH_TOKEN="ваш-kiro-api-key" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_MODEL="kr/claude-sonnet-4.5" \
  ANTHROPIC_SMALL_FAST_MODEL="kr/claude-sonnet-4.5" \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude'

# Через подписку Anthropic (выше лимиты)
alias ccp='ANTHROPIC_BASE_URL="" \
  ANTHROPIC_AUTH_TOKEN="" \
  ANTHROPIC_API_KEY="" \
  ANTHROPIC_MODEL="" \
  ANTHROPIC_SMALL_FAST_MODEL="" \
  claude'

cc — Kiro AI (бесплатно), ccp — подписка Anthropic. OmniRoute нужен только для режима cc.

Частые ошибки

better_sqlite3.node is not valid Win32 application

OmniRoute установился без @latest. Решение:

# Переустановить (рекомендуется)
npm install -g omniroute@latest

# Или пересобрать на месте (Windows)
cd C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\AppData\Roaming\npm\node_modules\omniroute\app
npm rebuild better-sqlite3

# macOS / Linux
cd $(npm root -g)/omniroute/app
npm rebuild better-sqlite3

Ошибка аутентификации Claude Code

Проверьте по очереди:

1. Запущен ли OmniRoute в другом терминале
2. Правильно ли указан порт в ANTHROPIC_BASE_URL
3. Не пустой ли ANTHROPIC_AUTH_TOKEN

Команда claude не найдена после npm install

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

1) Установка Node.js

Если ещё не установлен, то идём на https://nodejs.org/en скачиваем версию от v18 до v22 и устанавливаем

2) Установка OpenCode
Далее скачиваем IDE OpenCode https://opencode.ai/ru/download

3) Устанавливаем OpenRoute простой командой в командной строке npm install -g omniroute и после установки запускаем командой omniroute и у нас запускается локальный сервер в браузере, в начале задаем пароль, всё остальное можно проскипать и далее переходим в Providers -> Kiro AI.

В нём создаём аккаунт через AWS, достаточно просто подконнектится гугл аккаунтом, всё делается нативно.

Далее создаём API ключ

И идём в OpenCode и подключаем пользовательский провайдер и настраиваем

ID провайдера - любое название

Отображаемое имя - любое название

Базовый URL - http://localhost:20128/v1 если у вас будет порт отличаться, то укажите свой и просто в конце добавьте /v1

API ключ - берём из шага выше

Модели:

• model - id указываем - kr/claude-sonnet-4.5
• отображаемое имя - любое

И нажимает кнопку "Отправить"

ГОТОВО!

Просто выбираем в списке нашу модель и билдим 😉

P.S. Во время работы таким способом терминал в котором мы запустили OpenRoute должен оставаться в запущенном состоянии.