Claude Code в России

Claude Code — это мощный агентный инструмент от Anthropic для программирования. С AITUNNEL вы можете использовать Claude Code в России без VPN с любыми моделями.

Что такое Claude Code?

Claude Code — это AI-агент для программирования, который работает прямо в вашем терминале. В отличие от обычных чат-ботов, Claude Code может:

• Читать и редактировать файлы — автоматически вносит изменения в код
• Выполнять команды — запускает скрипты, тесты, билды
• Управлять браузером — автоматизирует веб-взаимодействия
• Работать с Git — создает коммиты, ветки, pull requests
• Понимать контекст проекта — анализирует структуру и зависимости

Почему Claude Code популярен?

Claude Code стал одним из самых популярных инструментов для AI-программирования благодаря:

1. Агентная архитектура — не просто отвечает на вопросы, а выполняет задачи
2. Model Context Protocol (MCP) — динамически подключает инструменты по мере необходимости
3. Lazy loading инструментов — экономит контекст, загружая только нужные tools
4. Глубокая интеграция с кодом — понимает зависимости, импорты, типы

Установка Claude Code

macOS и Linux

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

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Через npm (кроссплатформенно)

# Требуется Node.js 18+
npm install -g @anthropic-ai/claude-code

Через Homebrew (macOS)

brew install anthropic/tap/claude-code

Настройка Claude Code с AITUNNEL

Способ 1: Переменные окружения (рекомендуется)

Добавьте в ваш профиль оболочки (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish):

# Обязательные переменные
export ANTHROPIC_BASE_URL="https://api.aitunnel.ru"
export ANTHROPIC_AUTH_TOKEN="sk-aitunnel-xxx"
export ANTHROPIC_API_KEY=""  # ВАЖНО: должен быть пустым!

Почему ANTHROPIC_API_KEY должен быть пустым? Если эта переменная не установлена (null), Claude Code попытается аутентифицироваться на серверах Anthropic. Установка пустой строки предотвращает это.

Способ 2: Файл настроек проекта

Создайте .claude/settings.local.json в корне проекта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aitunnel.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-aitunnel-xxx",
    "ANTHROPIC_API_KEY": ""
  }
}

Этот способ удобен для командной работы — можно добавить файл в .gitignore и использовать разные настройки для разных проектов.

Способ 3: Глобальный конфиг

Создайте ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aitunnel.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-aitunnel-xxx",
    "ANTHROPIC_API_KEY": ""
  },
  "defaultModel": "sonnet"
}

Запуск и основные команды

Запуск сессии

cd /path/to/your/project
claude

CLI команды

# Запустить с начальным промптом
claude "Добавь тесты для всех функций в src/utils.ts"

# Запустить и сразу выйти (для скриптов)
claude -p "Проверь код на ошибки" --exit

# Продолжить последнюю сессию
claude -c

# Возобновить конкретную сессию
claude -r "session-id" "Продолжи работу"

# Настроить MCP серверы
claude mcp add filesystem

Slash-команды внутри Claude Code

Использование любых моделей через AITUNNEL

Claude Code по умолчанию использует модели Anthropic (Sonnet, Opus, Haiku), но через AITUNNEL вы можете переопределить их на любые другие модели:

# Переопределение моделей по уровням
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.2-codex"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.2-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gemini-2.5-flash"

Примеры конфигураций

Для максимальной производительности:

export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-opus-4.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.2-pro"

Для экономии:

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v3.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-5-mini"

Для программирования:

export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-5.2-codex"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.1-codex-max"

Проверка подключения

После настройки проверьте подключение командой /status:

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://api.aitunnel.ru
Model: sonnet (gpt-5.2-codex via override)

Также проверьте Панель активности AITUNNEL — запросы должны отображаться в реальном времени.

Создание кастомных навыков (Skills)

Claude Code позволяет расширять функциональность через файлы SKILL.md:

<!-- .claude/skills/deploy.md -->
# Deploy Skill

## Описание
Деплой приложения на production сервер.

## Команда
/deploy

## Инструкции
1. Запустить тесты: npm test
2. Собрать проект: npm run build
3. Загрузить на сервер: rsync -avz dist/ user@server:/app
4. Перезапустить сервис: ssh user@server "sudo systemctl restart app"

GitHub Actions интеграция

Используйте Claude Code в CI/CD:

name: AI Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Run Claude Code Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.AITUNNEL_API_KEY }}
          prompt: "Проверь изменения в этом PR на ошибки и security issues"
        env:
          ANTHROPIC_BASE_URL: https://api.aitunnel.ru

Примеры использования

Рефакторинг кода

> Преобразуй все callback-функции в async/await в файлах src/api/*.js

Написание тестов

> Напиши unit-тесты для всех публичных методов класса UserService

Code review

> Проанализируй код в src/auth/ на предмет security уязвимостей

Документация

> Сгенерируй JSDoc комментарии для всех функций в src/utils/

Миграции

> Обнови код для совместимости с React 19, учитывая breaking changes

Устранение неполадок

Ошибки авторизации

• Убедитесь, что ANTHROPIC_API_KEY установлен в пустую строку
• Проверьте правильность ANTHROPIC_AUTH_TOKEN

Tool use не работает

• Выбранная модель должна поддерживать function calling
• Используйте модели с сильными возможностями инструментов

Ошибки контекста

• Модели с контекстом менее 128K могут не подходить для больших проектов
• Используйте /compact для сжатия истории

Рекомендуемые модели для Claude Code

Преимущества AITUNNEL для Claude Code

• Работает в России — без VPN и блокировок
• Любые модели — не только Claude, но и GPT, Gemini, DeepSeek
• Оплата в рублях — от 299₽
• Для бизнеса — договор, акты, счета-фактуры
• Единый API ключ — для всех моделей