agentrouter-setup-guide

agent
Guvenlik Denetimi
Uyari
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Complete guide to run Claude Code CLI & VS Code with AgentRouter using a WAF bypass proxy

README.md

🚀 AgentRouter Setup Guide & WAF Bypass Proxy

Python FastAPI VS Code Cursor

Полное руководство по настройке и использованию бесплатного API (Claude Opus 4.8, GPT-5.5, 5.6) от шлюза AgentRouter в ваших любимых ИИ-редакторах. Включает локальный Python-прокси для обхода WAF (ошибки HTTP 401 Unauthorized и BrokenPipeError).


📋 Оглавление


🎁 Регистрация и получение API-ключа

AgentRouter временно раздает огромные стартовые бонусы для новых пользователей.

  1. Перейдите на сайт AgentRouter (с бонусом +$50).

  2. АККАУНТ ДОЛЖЕН БЫТЬ СТАРШЕ 3 ДЕКАБРЯ 2025 ГОДА ИНАЧЕ НИЧЕ НЕ ДАДУТ!!!

  3. Авторизуйтесь через свой аккаунт GitHub.

  4. Бонусы: Вы получите $125 за регистрацию через GitHub, $50 бонусом за вход, и $25 будет начисляться каждый день за вход в панель.

  5. В левом меню перейдите в API KeysCreate Key.

  6. Задайте имя (например, vscode-key) и скопируйте полученный токен (начинается на sk-...).

  7. Каждый день на AgentRouter дают +$25 баланса! Чтобы забрать бонус, не нужно менять API-ключ или заново настраивать прокси. Достаточно просто на сайте AgentRouter выйти из своего аккаунта и войти заново (Log out -> Log in) — $25 баланса мгновенно зачисляются на твой счет каждый день!


🛡️ Установка локального прокси (Обход WAF)

Серверы AgentRouter используют строгий WAF, блокирующий сторонние приложения по HTTP-заголовкам. Локальный прокси на Python перехватывает трафик, подменяет заголовки (User-Agent: codex_cli_rs) и обеспечивает чистый стриминг без обрывов.

Шаг 1. Зависимости

Убедитесь, что у вас установлен Python (обязательно отметьте Add Python to PATH при установке). Откройте терминал и выполните:

pip install fastapi uvicorn httpx

Шаг 2. Запуск

  1. Сохраните скрипт agentrouter_proxy.py (находится в этом репозитории) на свой компьютер.
  2. Запустите его в консоли:
python agentrouter_proxy.py
  1. Прокси запустится по адресу: http://127.0.0.1:8318. Держите консоль открытой, пока пользуетесь ИИ.

🔌 Интеграции с редакторами

Во всех настройках ниже мы пускаем трафик через наш локальный прокси.

1. Cline / Roo Code (VS Code)

  1. Откройте панель расширения в VS Code.
  2. Нажмите на шестеренку (Settings) → API Provider.
  3. Выберите провайдера Anthropic.
  4. Base URL: http://127.0.0.1:8318
  5. API Key: Ваш ключ sk-...
  6. Model: Вручную пропишите claude-opus-4-8 или gpt-5-5-turbo.

2. Официальный плагин Claude Code (VS Code)

Откройте параметры пользователя (Cmd/Ctrl+Shift+POpen User Settings (JSON)) и добавьте:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ВАШ_КЛЮЧ" },
    { "name": "ANTHROPIC_BASE_URL", "value": "http://127.0.0.1:8318" },
    { "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "value": "1" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-opus-4-8" }
  ],
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.initialPermissionMode": "acceptEdits"
}

Затем в настройках самого расширения включите Disable Login Prompt и перезапустите редактор.

3. GitHub Copilot (VS Code)

  1. Откройте боковую панель Copilot Chat.
  2. Перейдите в Управление моделями (Manage Models) → Добавить модель (Add Model) → Пользовательская конечная точка (Custom Endpoint).
  3. Название: AgentRouter
  4. API Key: Ваш ключ sk-...
  5. Формат:
    • Для Claude Opus выбирайте Messages
    • Для GPT-5.5 выбирайте Chat Completions
  6. Model ID: claude-opus-4-8 или gpt-5.5
  7. Base URL: http://127.0.0.1:8318 (для ## 🔀 Аддендум: Прямой Claude Opus & Мост Anthropic → OpenAI & Обход WAF

Актуально на 21 июля 2026:

  1. ОПУС ПОЧИНИЛИ! Разработчики AgentRouter устранили панику interface conversion: interface {} is nil при работе с инструментами (Tool Calling). Теперь оригинальные модели claude-opus-* работают стабильно напрямую.
  2. В связи с этим наш локальный прокси по умолчанию работает в режиме прямого проксирования Claude (AGENTROUTER_BRIDGE=false). Вы получаете чистый нативный Claude Opus.
  3. При этом в прокси встроен автоматический WAF-байпас (Cyrillic-Bypass), который спасает от ошибок 500 sensitive_words_detected при отправке больших системных промптов (вроде Мастер-Конспектов).

🛠️ 1. Как работает обход WAF (Cyrillic-Bypass)

Прокси прозрачно выполняет двунаправленную замену:

  • При отправке запроса на AgentRouter все английские буквы c в тексте промпта заменяются на визуально идентичную русскую с. Это ломает сигнатуры WAF, и запросы гарантированно проходят с кодом 200 OK.
  • При получении ответа от модели все русские с заменяются обратно на английские c. В итоге Claude Code получает синтаксически идеальный английский код без повреждения символов.

🌉 2. Мост на OpenAI (gpt-5.5 / glm-5.2)

Если вам по какой-то причине нужно перевести трафик на OpenAI-совместимые модели, вы можете активировать мост (перевод Anthropic /v1/messages -> OpenAI /v1/chat/completions):

  • Модель gpt-5.5 (мощная модель, отлично понимает системные промпты и вызовы инструментов).
  • Модель glm-5.2 (отличается высокой скоростью и низкой стоимостью).

Как управлять режимами

Быстрее всего запускать прокси через run_proxy.bat на Рабочем столе (там есть интерактивное меню).

Если вы запускаете вручную, используйте переменные окружения:

Для Windows (PowerShell):

# Запуск чистого Claude Opus (по умолчанию):
$env:AGENTROUTER_BRIDGE="false"
python agentrouter_proxy.py

# Мост на gpt-5.5:
$env:AGENTROUTER_BRIDGE="true"
$env:AGENTROUTER_BRIDGE_MODEL="gpt-5.5"
python agentrouter_proxy.py

# Мост на GLM-5.2:
$env:AGENTROUTER_BRIDGE="true"
$env:AGENTROUTER_BRIDGE_MODEL="glm-5.2"
python agentrouter_proxy.py

Для Linux / macOS (Bash):

# Запуск чистого Claude Opus (по умолчанию):
export AGENTROUTER_BRIDGE="false"
python agentrouter_proxy.py

📋 Поддерживаемые функции

  • ✅ Обычный текстовый диалог (со стримингом и без)
  • ✅ Сложные системные промпты (включая Мастер-Конспекты)
  • ✅ Вызовы инструментов (Tool Use / Function Calling) — чтение, запись и редактирование файлов в нативном и мостовом режимах
  • ✅ Мультимодальность (передача изображений)
  • ✅ Переопределение параметров temperature, top_p, max_tokens�рументов (Tool Calling). Попытка запустить оригинальный Claude Code / Cline напрямую приводит к системной панике на их сервере (Panic detected, error: interface conversion: interface {} is nil).
  1. Кроме того, WAF AgentRouter жестко блокирует длинные промпты (особенно системные инструкции) с ошибкой 500 sensitive_words_detected.

Наш прокси решает обе проблемы полностью в автоматическом режиме:

🛠️ 1. Автоматический обход WAF (Cyrillic-Bypass)

Прокси прозрачно выполняет двунаправленную замену:

  • При отправке запроса на AgentRouter все английские буквы c в тексте промпта заменяются на визуально идентичную русскую с. Это ломает сигнатуры WAF, и запросы гарантированно проходят с кодом 200 OK.
  • При получении ответа от модели все русские с заменяются обратно на английские c. В итоге Claude Code получает синтаксически идеальный английский код без повреждения символов.

🌉 2. Мост Anthropic → OpenAI (gpt-5.5 / glm-5.2)

Поскольку оригинальный Claude с инструментами падает в панику на стороне AgentRouter, прокси по умолчанию переводит все вызовы Anthropic /v1/messages в OpenAI-совместимый формат:

  • По умолчанию запросы направляются на gpt-5.5 (мощную модель, отлично понимающую системные промпты и вызовы инструментов).
  • Вы также можете использовать модель glm-5.2 (отличается высокой скоростью и низкой стоимостью).

Как переключать модели

Модели переключаются через переменную окружения AGENTROUTER_BRIDGE_MODEL при запуске прокси:

Для Windows (PowerShell):

# Переключить на GLM-5.2 (работает быстро и дешево):
$env:AGENTROUTER_BRIDGE_MODEL="glm-5.2"
python agentrouter_proxy.py

# Вернуть gpt-5.5 (по умолчанию):
$env:AGENTROUTER_BRIDGE_MODEL="gpt-5.5"
python agentrouter_proxy.py

Для Linux / macOS (Bash):

# Переключить на GLM-5.2:
export AGENTROUTER_BRIDGE_MODEL="glm-5.2"
python agentrouter_proxy.py

📋 Поддерживаемые функции моста

  • ✅ Обычный текстовый диалог (со стримингом и без)
  • ✅ Сложные системные промпты (включая Мастер-Конспекты)
  • ✅ Вызовы инструментов (Tool Use / Function Calling) — чтение, запись и редактирование файлов
  • ✅ Мультимодальность (передача изображений)
  • ✅ Переопределение параметров temperature, top_p, max_tokens

💡 Ежедневный бонус $25 баланса:
Каждый день на AgentRouter дают +$25 баланса! Чтобы забрать бонус, не нужно менять API-ключ или заново настраивать прокси. Достаточно просто на сайте AgentRouter выйти из своего аккаунта и войти заново (Log out -> Log in) — $25 баланса мгновенно зачисляются на твой счет каждый день!

💰 Актуальный список моделей AgentRouter (5 моделей)

ID Модели Тип эндпоинта Model Ratio Completion Ratio Вход (Prompt) Выход (Completion)
claude-opus-4-8 Anthropic / OpenAI 4.0x 5.0x $8.00 / 1M $40.00 / 1M
gpt-5.6-sol OpenAI 2.0x 5.0x $4.00 / 1M $20.00 / 1M
gpt-5.5 OpenAI 3.0x 1.5x $6.00 / 1M $9.00 / 1M
glm-5.2 OpenAI 2.0x 2.0x $4.00 / 1M $8.00 / 1M
kimi-k3 OpenAI 2.0x 2.0x $4.00 / 1M $8.00 / 1M

Yorumlar (0)

Sonuc bulunamadi