> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Использование APIMart в Claude Code > Подробное руководство по настройке и использованию API-сервиса APIMart в CLI Claude Code, позволяющее получить доступ к нескольким AI-моделям для помощи в программировании с простой конфигурацией. Claude Code Main Interface ## Предварительные требования Claude Code — это AI-ассистент программиста с командной строкой от Anthropic, который поддерживает прямое общение с ИИ, генерацию кода и отладку в терминале. Подключившись к APIMart, вы можете использовать в Claude Code несколько моделей, включая GPT, Claude и Gemini. Перед началом убедитесь, что: 1. **Получен API-ключ APIMart** Войдите в [консоль APIMart](https://apimart.ai/keys), чтобы получить API-ключ (начинается с `sk-`) **Совет:** если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на [APIMart](https://apimart.ai) и получите API-ключ. ## Шаг 1: Установите Claude Code Выберите любой из следующих способов установки: Установка через официальный скрипт: ```bash theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` Или установка через Homebrew: ```bash theme={null} brew install --cask claude-code ``` Если возникнут проблемы с правами, добавьте `sudo` перед командой. **PowerShell:** ```powershell theme={null} irm https://claude.ai/install.ps1 | iex ``` **CMD:** ```cmd theme={null} curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd ``` Если у вас установлен Node.js 18 или новее, можно установить через npm: ```bash theme={null} npm install -g @anthropic-ai/claude-code ``` Работает на всех операционных системах. ### Проверка установки После установки выполните следующую команду для подтверждения: ```bash theme={null} claude --version ``` Если отображается номер версии (например, `1.x.x`), установка прошла успешно. ## Шаг 2: Настройте API APIMart Доступны три способа настройки. Выберите тот, который подходит вашему рабочему процессу. ### Способ 1: Редактирование settings.json (рекомендуется) Самый стабильный подход — настройте один раз, и конфигурация сохраняется. **1. Найдите директорию конфигурации:** * Windows: нажмите `Win + R`, введите `%userprofile%\.claude` * macOS: нажмите `Command + Shift + G`, введите `~/.claude` * Linux: перейдите в `~/.claude` Если директории не существует, выполните `claude` в терминале и нажмите `Ctrl + C` для выхода — директория создастся автоматически. **2. Создайте или отредактируйте файл `settings.json`:** ```json theme={null} { "env": { "ANTHROPIC_BASE_URL": "https://api.apimart.ai", "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx", "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } } ``` | Параметр | Описание | | ------------------------------------------ | -------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Адрес API APIMart, фиксированный `https://api.apimart.ai` | | `ANTHROPIC_AUTH_TOKEN` | Ваш API-ключ APIMart (начинается с `sk-`) | | `ANTHROPIC_MODEL` | Модель по умолчанию, выберите из списка моделей ниже | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Установите `1`, чтобы сократить второстепенные сетевые запросы | Сохраните файл и перезапустите Claude Code для применения. ### Способ 2: Постоянные переменные окружения Запишите конфигурацию в системное окружение, чтобы все терминалы её подгружали автоматически. ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc source ~/.zshrc ``` ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc source ~/.bashrc ``` **Вариант A: GUI-настройки** 1. Кликните правой кнопкой на «Этот компьютер» → «Свойства» → «Дополнительные параметры системы» → «Переменные среды» 2. Добавьте новые пользовательские переменные: * `ANTHROPIC_BASE_URL` = `https://api.apimart.ai` * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx` * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart` 3. Перезапустите терминал **Вариант B: команды PowerShell** ```powershell theme={null} [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User') ``` ### Способ 3: Временные переменные окружения Подходит для быстрого тестирования — конфигурация теряется при закрытии терминала. ```bash theme={null} export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" export ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```powershell theme={null} $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart" $env:ANTHROPIC_BASE_URL="https://api.apimart.ai" claude ``` ```cmd theme={null} set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart set ANTHROPIC_BASE_URL=https://api.apimart.ai claude ``` Временные переменные окружения работают только в текущем окне терминала. После переключения окон или закрытия терминала нужно задать их снова. ## Шаг 3: Начните использование ### Проверка конфигурации Запустите Claude Code и отправьте простое сообщение для подтверждения: ```bash theme={null} claude "Hello" ``` Если получите ответ ИИ — конфигурация настроена. При ошибках `401`, `403` и др. см. FAQ ниже. ### Режимы использования Claude Code предлагает два режима взаимодействия: * **Интерактивный режим**: выполните `claude` для непрерывного диалога, подходит для сложных задач * **Одиночная команда**: выполните `claude "ваш вопрос"` для разового ответа, подходит для быстрых запросов ### Поддерживаемые модели APIMart поддерживает полный набор моделей Claude. Можно гибко переключаться по потребности: | Имя модели | Особенности | Рекомендуемое использование | | ---------------------------- | ---------------------------------------------- | --------------------------------------------- | | `claude-opus-4-6` | Самая мощная в целом | Сложная архитектура, трудная отладка | | `claude-sonnet-4-6` | Сбалансированная производительность и скорость | Повседневное программирование, генерация кода | | `claude-opus-4-5-20251101` | Продвинутое рассуждение | Сложный код, глубокий анализ | | `claude-sonnet-4-5-20250929` | Отличные навыки кода | Алгоритмы, оптимизация кода | | `claude-haiku-4-5-20251001` | Сверхбыстрый ответ | Быстрые вопросы-ответы, фрагменты кода | Все указанные модели поддерживают версию Thinking (расширенного рассуждения) — добавьте `-thinking` к ID модели, например, `claude-opus-4-6-thinking`. Режим Thinking идеален для сложных задач, требующих глубокого рассуждения. #### Скидочные модели APIMart APIMart предлагает эксклюзивные скидочные модели **всего за 20% от официальной цены** с теми же возможностями. Просто добавьте `-apimart` к ID модели: | Имя скидочной модели | Особенности | | ------------------------------------ | ---------------------------------------------- | | `claude-opus-4-6-apimart` | Самая мощная в целом | | `claude-sonnet-4-6-apimart` | Сбалансированная производительность и скорость | | `claude-opus-4-5-20251101-apimart` | Продвинутое рассуждение | | `claude-sonnet-4-5-20250929-apimart` | Отличные навыки кода | | `claude-haiku-4-5-20251001-apimart` | Сверхбыстрый ответ | Версии Thinking также доступны, например, `claude-opus-4-6-thinking-apimart`, `claude-sonnet-4-6-thinking-apimart` и т. д. **Рекомендации по моделям:** * 💰 **Лучшая цена/качество:** `claude-sonnet-4-6-apimart` — лучший выбор для повседневного программирования, всего 20% от официальной цены * 🚀 **Высокая производительность:** `claude-opus-4-6-apimart` — для самых сложных задач кода и архитектуры * ⚡ **Быстрый ответ:** `claude-haiku-4-5-20251001-apimart` — когда нужен мгновенный фидбэк * 🧠 **Глубокое мышление:** `claude-opus-4-6-thinking-apimart` — когда нужно глубокое рассуждение Для переключения моделей используйте команду `/model` в интерактивном режиме или измените поле `ANTHROPIC_MODEL` в конфигурации и перезапустите. ### Распространённые команды Часто используемые команды и горячие клавиши Claude Code: | Команда | Описание | | ------------------ | ----------------------------------------- | | `claude` | Войти в интерактивный режим | | `claude "вопрос"` | Одиночный запрос | | `claude --version` | Узнать версию | | `/model` | Переключить модель в интерактивном режиме | | `/help` | Просмотреть справку | | `Ctrl + C` | Выйти из интерактивного режима | ## Часто задаваемые вопросы ### Q1: После настройки всё ещё показывается страница выбора входа? Если «Select login method» всё ещё появляется после запуска, конфигурация не вступила в силу. **Шаги устранения:** 1. **С использованием settings.json**: проверьте, что путь к файлу корректен * Windows: `C:\Users\\.claude\settings.json` * macOS / Linux: `~/.claude/settings.json` 2. **С переменными окружения**: убедитесь, что Claude Code запущен из **того же окна терминала**, где были заданы переменные 3. **Проверьте JSON-формат**: убедитесь, что скобки, запятые и кавычки корректны ### Q2: Ошибки 401 / 403? | Код ошибки | Значение | Решение | | ------------------ | --------------------------------------- | ---------------------------------------------------------------------------- | | `401 Unauthorized` | API-ключ отсутствует или недействителен | Проверьте корректность ключа и что он начинается с `sk-` | | `403 Forbidden` | Недостаточно прав или ключ истёк | Перейдите в [консоль](https://apimart.ai/keys), чтобы проверить статус ключа | Также убедитесь, что `ANTHROPIC_BASE_URL` установлен на `https://api.apimart.ai`, а не на официальный адрес Anthropic. ### Q3: Ошибка «Unable to connect»? Это означает, что Claude Code не смог подключиться к API-сервису. 1. Проверьте сетевое подключение 2. Проверьте, что `ANTHROPIC_BASE_URL` настроен корректно 3. Если используется прокси, убедитесь, что он разрешает доступ к `api.apimart.ai` ### Q4: Ошибка «Auth conflict»? Если вы видите сообщение вроде: ``` Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set. ``` Это означает, что вы залогинены в claude.ai и одновременно установлен API Key — возникает конфликт. **Решение:** выполните `/logout` в интерактивном режиме Claude Code, чтобы выйти из claude.ai, оставив только конфигурацию API Key. ### Q5: Ошибка max\_tokens при использовании моделей не-Claude? Если видите ошибку вроде: ``` max_tokens is too large: 32000. This model supports at most 16384 completion tokens. ``` Это потому что Claude Code по умолчанию отправляет запросы с параметрами модели Claude (32000 токенов), а у некоторых не-Claude моделей (например, `gpt-4o`) ниже лимит токенов. **Решение:** переключитесь на модель Claude (например, `claude-sonnet-4-6-apimart`), которая нативно совместима с Claude Code и не вызовет эту проблему. ### Q6: Медленный отклик? 1. Переключитесь на более быструю модель (например, `claude-haiku-4-5-20251001-apimart` или `claude-sonnet-4-6-apimart`) 2. Сократите промпты, чтобы уменьшить длину контекста 3. Проверьте состояние сети ### Q7: Как переключать модели? Два способа: 1. **В интерактивном режиме**: введите команду `/model` 2. **Редактирование конфигурации**: измените поле `ANTHROPIC_MODEL` в `settings.json` или переменных окружения, затем перезапустите Claude Code ### Q8: Читает ли Claude Code локальные файлы автоматически? Нет. Claude Code требует, чтобы вы явно ссылались на файлы, и спросит подтверждение перед выполнением чувствительных операций. Рекомендуется использовать его в специально выделенных директориях проектов. ### Q9: Как анализировать локальные файлы с Claude Code? В интерактивном режиме можно ссылаться на файлы: * Введя путь к файлу напрямую * Перетащив файл в окно терминала * Скопировав и вставив содержимое файла ### Q10: Как проверить использование и расходы? Войдите в [консоль APIMart](https://apimart.ai/overview), чтобы посмотреть: * Статистику вызовов API * Детали потребления токенов * Статистику и тенденции расходов ## Поддержка Если у вас возникнут проблемы: * 📚 [Документация APIMart](https://docs.apimart.ai) * 💬 [Сообщество Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Техническая поддержка: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и испытайте мультимодельного ассистента программиста в Claude Code!