Claude Code API
Claudee=Эта инструкция поможет подключить API-ключ к Claude Code CLI.
Если вы никогда раньше не работали с API - всё нормально. Просто идите по шагам.
0. Быстрый старт
Вам нужно сделать 5 шагов:
- Установить Claude Code.
- Войти в Claude Code через аккаунт Claude.
- Вставить API-ключ в
settings.json. - Запустить Claude Code командой:
claude
- Проверить подключение:
Reply exactly: OK Do not edit files.
Если Claude ответил:
OK
значит всё работает.
1. Что это такое
Вы купили API-ключ для Claude Code CLI.
Простыми словами:
Claude Code - программа для работы с кодом через терминал.
API Key - ваш личный ключ доступа.
Base URL - адрес сервиса, куда Claude Code отправляет запросы.
Dashboard - личная страница, где можно смотреть баланс и расход.
Важно:
Это не обычный Claude в браузере. Это не ChatGPT. Это не генератор картинок. Это не OpenAI API. Это ключ именно для Claude Code CLI.
Подходит для:
- Claude Code - вайбкодинга - работы с проектами - сайтов - Telegram-ботов - скриптов - автоматизаций - анализа и правки кода
2. Где это работает
Основной вариант:
Claude Code CLI
То есть вы открываете Terminal / PowerShell и запускаете:
claude
В VS Code использовать тоже можно, но правильно так:
VS Code → Terminal или Claude Code extension → команда claude → Claude Code API
Важно:
Этот ключ не подключается как обычный OpenAI Compatible API в Cline / Roo / Kilo / Cursor. Он рассчитан именно на Claude Code CLI.
3. Главный адрес API
Для этого продукта используется Base URL:
https://claude-code-cli.vibecode-claude.online
Именно этот адрес должен быть в настройках Claude Code.
4. Что нужно перед началом
Подготовьте:
1. API-ключ, который вы получили после покупки. 2. Terminal на Mac/Linux или PowerShell на Windows. 3. Установленный Claude Code. 4. Аккаунт Claude для входа в Claude Code. 5. Claude Code версии 2.1.150 или новее.
Проверить версию:
claude --version
Если версия ниже 2.1.150, обновите:
claude update
5. Как открыть Terminal / PowerShell
Mac
Нажмите:
Command + Space
Напишите:
Terminal
Нажмите Enter.
Или вручную:
Finder → Applications → Utilities → Terminal
На русском:
Finder → Программы → Утилиты → Терминал
Windows
Откройте PowerShell.
Самый простой способ:
Пуск → PowerShell
или нажмите Win, напишите PowerShell, откройте приложение.
6. Установка Claude Code
Если Claude Code уже установлен, этот раздел можно пропустить.
Mac / Linux
Вставьте в Terminal:
curl -fsSL https://claude.ai/install.sh | bash
После установки полностью закройте Terminal и откройте заново.
Проверьте:
claude --version
Если появилась версия - Claude Code установлен.
Windows PowerShell
Вставьте в PowerShell:
irm https://claude.ai/install.ps1 | iex
После установки полностью закройте PowerShell и откройте заново.
Проверьте:
claude --version
Если появилась версия - Claude Code установлен.
7. Авторизация в Claude Code
Запустите Claude Code:
claude
Если Claude Code предложит варианты входа, выберите вход через аккаунт Claude.
Обычно это вариант 2.
После этого откроется браузер. Войдите в аккаунт Claude.
Можно использовать обычный аккаунт Claude. Если Claude предлагает подписку - её можно пропустить.
После авторизации вернитесь в Terminal / PowerShell.
8. Главный способ подключения - через settings.json
Это лучший способ. Вы один раз вставляете ключ в файл настроек, и Claude Code дальше работает постоянно.
8.1. Откройте settings.json
Claude Code настраивается через файл:
settings.json
Mac / Linux
Файл находится здесь:
~/.claude/settings.json
Чтобы открыть его на Mac, вставьте в Terminal:
mkdir -p ~/.claude touch ~/.claude/settings.json cp ~/.claude/settings.json ~/.claude/settings.backup.json 2>/dev/null open -e ~/.claude/settings.json
Откроется TextEdit.
Windows
Файл находится здесь:
C:\Users\ВАШ_ПОЛЬЗОВАТЕЛЬ\.claude\settings.json
Например:
C:\Users\Anatolii\.claude\settings.json
Чтобы открыть файл через PowerShell:
mkdir "$env:USERPROFILE\.claude" -Force Copy-Item "$env:USERPROFILE\.claude\settings.json" "$env:USERPROFILE\.claude\settings.backup.json" -ErrorAction SilentlyContinue notepad "$env:USERPROFILE\.claude\settings.json"
Откроется Notepad.
9. Вставьте настройки
Полностью удалите содержимое файла settings.json и вставьте это:
{
"env": {
"ANTHROPIC_BASE_URL": "https://claude-code-cli.vibecode-claude.online",
"ANTHROPIC_API_KEY": "ВСТАВЬТЕ_СЮДА_ВАШ_API_KEY",
"DISABLE_TELEMETRY": "1",
"DISABLE_ERROR_REPORTING": "1",
"CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1",
"DISABLE_AUTOUPDATER": "1",
"DISABLE_BUG_COMMAND": "1",
"DISABLE_COST_WARNINGS": "1",
"DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
"CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1"
}
}
Теперь замените:
ВСТАВЬТЕ_СЮДА_ВАШ_API_KEY
на ваш настоящий ключ.
Пример:
"ANTHROPIC_API_KEY": "sk-ant-cap01-xxxxxxxxxxxxxxxx"
Важно:
Кавычки вокруг ключа оставляем. Запятые не удаляем. Лишние пробелы в ключ не добавляем. Файл должен называться settings.json. Не settings.json.txt. Не settings.jsor.
10. Важная проверка settings.json
В файле должен быть один общий JSON-блок.
Неправильно:
{
"theme": "dark"
}
{
"env": {
"ANTHROPIC_API_KEY": "..."
}
}
Правильно:
{
"env": {
"ANTHROPIC_BASE_URL": "https://claude-code-cli.vibecode-claude.online",
"ANTHROPIC_API_KEY": "..."
}
}
Если в файле остались старые строки от другого API - лучше временно удалить их.
Особенно проверьте, чтобы не было конфликтующих строк:
ANTHROPIC_BASE_URL ANTHROPIC_API_KEY ANTHROPIC_CUSTOM_HEADERS
Если они есть в другом месте файла и указывают на другой сервис - подключение может не заработать.
11. Сохраните файл
Mac
Нажмите:
Command + S
Закройте TextEdit.
Windows
Нажмите:
Ctrl + S
Закройте Notepad.
12. Перезапустите Claude Code
Полностью закройте старый Terminal / PowerShell.
Откройте новый Terminal / PowerShell.
Создайте тестовую папку.
Mac / Linux
mkdir -p ~/AI-Tests/claude-code-test cd ~/AI-Tests/claude-code-test claude
Windows
mkdir "$env:USERPROFILE\AI-Tests\claude-code-test" -Force cd "$env:USERPROFILE\AI-Tests\claude-code-test" claude
13. Если Claude спросит про API key
Может появиться вопрос:
Do you want to use this API key? 1. Yes 2. No
Выберите:
1. Yes
Важно: иногда по умолчанию выбран No, поэтому внимательно смотрите перед нажатием Enter.
Если случайно выбрать No, ключ может не заработать.
14. Если появилось Auth Conflict
Claude Code может показать предупреждение:
Auth Conflict
Это не всегда проблема.
Если Claude отвечает - можно работать.
Если не отвечает, можно выйти из Claude-аккаунта:
/logout
Потом снова запустить:
claude
15. Проверьте статус
Внутри Claude Code напишите:
/status
В статусе должно быть примерно так:
API key: ANTHROPIC_API_KEY Anthropic base URL: https://claude-code-cli.vibecode-claude.online
Если это видно - Claude Code подхватил API.
16. Первый тест
Внутри Claude Code напишите:
Reply exactly: OK Do not edit files.
Если Claude ответил:
OK
значит подключение работает.
17. Первый тест с файлом
После успешного OK можно проверить, что Claude Code умеет работать с файлами.
Напишите:
Создай файл hello.txt с текстом: Claude Code works. Потом прочитай файл и покажи результат.
Если файл создался и Claude показал текст - всё работает.
18. Как менять модель
Внутри Claude Code напишите:
/model
Там можно выбрать модель.
Обычно логика такая:
Sonnet - для обычной работы и вайбкодинга. Opus - для сложных задач, архитектуры и тяжёлого кода. Haiku - для простых вопросов и мелких задач.
Если с новой Opus-моделью появляется ошибка или rate limit, временно переключитесь на более стабильную Opus 4.7 или Sonnet.
19. Быстрый временный способ без settings.json
Этот способ работает только в рамках одного открытого терминала.
Если закрыть Terminal / PowerShell, команды придётся вводить заново.
Для постоянной работы лучше использовать способ через settings.json.
Windows PowerShell
Вставьте:
$env:ANTHROPIC_BASE_URL="https://claude-code-cli.vibecode-claude.online" $env:ANTHROPIC_CUSTOM_HEADERS="X-Api-Key: ВСТАВЬТЕ_СЮДА_ВАШ_API_KEY" claude
Mac / Linux
Вставьте:
export ANTHROPIC_BASE_URL="https://claude-code-cli.vibecode-claude.online" export ANTHROPIC_CUSTOM_HEADERS="X-Api-Key: ВСТАВЬТЕ_СЮДА_ВАШ_API_KEY" claude
Важно:
Этот способ временный. После закрытия терминала настройки пропадут. Для постоянной работы используйте settings.json.
20. Dashboard и баланс
Откройте dashboard:
https://claude-code-cli.vibecode-claude.online/dashboard
Вставьте ваш API key.
Там можно смотреть:
- сколько токенов осталось - сколько уже использовано - историю запросов - ошибки - расход по моделям
Если dashboard не открывается, попробуйте другой браузер или VPN.
21. AI Assistant в dashboard
В правом нижнем углу dashboard есть AI Assistant.
Он помогает по техническим вопросам API.
Можно спрашивать:
- как подключить ключ - почему ошибка 401 - почему ошибка 403 - почему ошибка 524 - как проверить модель - почему Claude Code не видит ключ
Важно:
AI Assistant помогает по технической части. По покупке, цене, возвратам и коммерческим вопросам пишите продавцу.
22. Как перенести баланс с нового ключа на старый
Если вы купили новый ключ, но не хотите заново менять settings.json, можно перенести баланс на текущий ключ.
Это удобно, когда:
- у вас закончился баланс - вы купили новый ключ - не хотите снова менять настройки - хотите продолжать работать на старом API key
Как сделать:
- Откройте dashboard:
https://claude-code-cli.vibecode-claude.online/dashboard
- Войдите под текущим ключом, на который хотите перенести баланс.
- Найдите блок:
Transfer balance from any key to your current one
или:
Перенести баланс с любого ключа на текущий
- Вставьте новый ключ, с которого хотите перенести баланс.
- Нажмите:
Preview / Проверить
- Проверьте, что всё правильно.
- Подтвердите перенос.
После этого баланс нового ключа перейдёт на текущий ключ.
Важно:
Старый ключ, который уже прописан в Claude Code, менять не нужно. Вы просто пополняете его баланс через новый купленный ключ.
Пример:
У вас в Claude Code прописан старый ключ. На нём осталось мало баланса. Вы купили новый ключ. Открыли dashboard старого ключа. Вставили новый ключ в Transfer balance. Перенесли баланс. Продолжили работать без изменения settings.json.
23. Один ключ - одно устройство
Один ключ привязывается к устройству после первого запроса.
Это защита от передачи одного ключа нескольким людям.
Если использовать тот же ключ с другого компьютера, он может не работать.
Обычно привязка сбрасывается через несколько часов.
Если нужно работать на другом устройстве, лучше использовать отдельный ключ.
24. Почему Claude Code расходует токены быстрее обычного чата
Claude Code тратит токены активнее, чем обычный чат.
Почему:
- Claude видит системные инструкции. - Claude видит инструменты. - Claude может читать файлы. - Claude может писать файлы. - Claude может запускать команды. - Claude держит контекст задачи.
Примерно:
Короткий вопрос - мало расхода. Маленькая coding-задача - больше. Задача с файлами и командами - ещё больше. Большой проект и длинный контекст - расход может быть высоким.
Чтобы экономить:
1. Не просите сразу "изучи весь проект". 2. Не отправляйте огромные файлы без причины. 3. Сначала просите план, потом реализацию. 4. Делите большую задачу на маленькие шаги. 5. Для обычных задач используйте Sonnet. 6. Opus включайте для сложных задач. 7. Haiku используйте для простых вопросов. 8. Не запускайте много агентов без необходимости.
Хороший запрос:
Посмотри только файл payment.py. Найди возможную причину ошибки. Пока ничего не меняй. Сначала дай план.
Плохой запрос:
Изучи весь проект и всё исправь.
25. Как правильно писать задачи в Claude Code
Claude Code можно использовать как чат, но лучше писать задачи структурно.
Формат хорошего запроса:
Контекст: что я делаю Задача: что нужно сделать Ограничения: что нельзя трогать Формат ответа: как именно ответить
Пример:
Контекст: я делаю Telegram-бота для продажи цифровых товаров. Задача: создай простой модуль покупки товара. Ограничения: не используй базу данных, не устанавливай пакеты, не трогай другие файлы. Формат ответа: создай файл product.py и коротко объясни, что сделал.
26. Готовые первые промпты
Проверка подключения
Reply exactly: OK Do not edit files.
Маленькая задача с файлом
Создай файл hello.txt с текстом: Claude Code works. Потом прочитай файл и покажи результат.
Безопасный анализ проекта
Посмотри структуру проекта. Ничего не меняй. Не запускай команды установки. Не делай git push. Сначала дай краткий план, какие файлы нужно изучить.
Большая задача без риска
Сначала сделай только анализ. Ничего не меняй. Опиши план из 5 шагов. После этого я отдельно разрешу первый шаг.
27. Частые ошибки и решения
Low balance / add funds / insufficient credits
Если Claude Code пишет что-то вроде:
low balance add funds insufficient credits
и вы только что подключили ключ, скорее всего API не подтянулся.
Проверьте:
1. В settings.json указан Base URL: https://claude-code-cli.vibecode-claude.online 2. API key вставлен полностью. 3. Вы выбрали Yes, когда Claude спросил про API key. 4. В settings.json нет конфликтующих строк от другого API. 5. Claude Code перезапущен после изменения settings.json.
401 Invalid Key
Возможные причины:
- ключ вставлен не полностью - ключ вставлен с пробелом - ключ уже неактивен - указан неправильный Base URL - нажали No вместо Yes - settings.json содержит старые конфликтующие поля
Что сделать:
1. Скопируйте ключ заново. 2. Проверьте, что нет пробела в начале или конце. 3. Проверьте Base URL. 4. Проверьте settings.json. 5. Перезапустите Claude Code. 6. Проверьте dashboard.
403
Чаще всего запрос идёт не туда.
Проверьте, что Base URL именно такой:
https://claude-code-cli.vibecode-claude.online
429
Это может быть rate limit.
Что сделать:
1. Подождите несколько минут. 2. Не отправляйте много одинаковых запросов подряд. 3. Переключитесь на другую модель через /model. 4. Если ошибка на Opus, попробуйте Sonnet или другую Opus-версию. 5. Разбейте задачу на меньшие части.
Retry 2/10, 3/10 и так далее
Если Claude Code показывает:
Retrying 2/10 Retrying 3/10
не спамьте новые запросы.
Подождите, пока он дойдёт до конца.
Если появится ошибка, сделайте скриншот и отправьте в поддержку.
ECONNECTION RESET
Чаще всего это проблема соединения или VPN.
Что сделать:
1. Включите VPN. 2. Смените страну VPN. 3. Лучше попробовать США. 4. Перезапустите Claude Code. 5. Попробуйте снова.
Даже если другие сайты работают, именно этот маршрут может конфликтовать с вашим IP.
502 или 503
Обычно это временная проблема сервиса или перегрузка.
Что сделать:
1. Подождите 10-15 минут. 2. Перезапустите Claude Code. 3. Попробуйте другую модель. 4. Если долго не проходит - напишите в поддержку.
524 / timeout
Это значит, что запрос дошёл до сервера, но сервер не успел ответить за лимит времени.
Такое может быть на длинных agent-задачах, больших генерациях или при перегрузе.
Что сделать:
1. Подождите 1-2 минуты. 2. Не отправляйте сразу 10 повторов. 3. Разбейте задачу на меньшие шаги. 4. Сначала попросите план. 5. Потом попросите выполнить только первый шаг. 6. Для тяжёлых задач попробуйте Opus. 7. Для обычных задач используйте Sonnet. 8. Проверьте VPN.
Плохой запрос:
Сделай весь проект полностью, изучи все файлы, всё исправь и запусти.
Хороший запрос:
Сначала изучи только структуру проекта. Ничего не меняй. Дай план из 5 шагов.
Please log in
Если Claude Code пишет:
please log in
или что-то похожее, войдите в Claude-аккаунт.
Запустите:
claude
Выберите вход через аккаунт Claude.
Можно использовать обычный аккаунт.
Model Not Found
Лучше менять модель через:
/model
Если какая-то модель не работает, выберите другую.
Обычно:
Sonnet - обычная работа. Opus - сложные задачи. Haiku - простые задачи.
Python was not found
Это не ошибка API.
Это значит, что на компьютере не установлен Python.
Если задача требует Python, установите Python с официального сайта.
Если Python не нужен, попросите Claude использовать PowerShell, Bash или другой инструмент, который уже установлен.
Ключ не работает на другом компьютере
Один ключ привязывается к одному устройству после первого запроса.
Если вы хотите работать на другом устройстве, лучше использовать отдельный ключ.
28. Как писать в поддержку
Не пишите просто:
Не работает.
Так невозможно быстро понять причину.
Лучше отправьте:
1. Где настраиваю: Claude Code CLI 2. Операционная система: Windows / macOS / Linux 3. Версия Claude Code: что показывает claude --version 4. Base URL: что указали 5. Ошибка: 401 / 403 / 429 / 502 / 503 / 524 / ECONNECTION RESET / другое 6. Что уже пробовали: перезапуск / смена VPN / другая модель 7. Скриншот ошибки: прикрепляю
Важно:
Не отправляйте полный API Key в поддержку.
Можно отправить только начало и конец:
sk-ant...abcd
29. Безопасность
API Key - это как пароль.
Не отправляйте его:
- в публичные чаты - в Telegram-группы - друзьям - подрядчикам - на скриншотах - в чужие сервисы
Если кто-то получит ваш ключ, он сможет потратить ваш баланс.
Если ключ случайно засветился - лучше заменить его.
30. Как вернуться обратно на обычный Claude Code
Если вы раньше пользовались Claude Code через свой аккаунт Claude и хотите вернуть всё назад, нужно убрать API-настройки из settings.json.
Mac / Linux
Закройте Claude Code.
Верните backup:
cp ~/.claude/settings.backup.json ~/.claude/settings.json
Если backup не делали, откройте файл:
open -e ~/.claude/settings.json
Удалите строки с:
ANTHROPIC_BASE_URL ANTHROPIC_API_KEY ANTHROPIC_CUSTOM_HEADERS
Сохраните файл и запустите:
claude
Windows
Закройте Claude Code.
Верните backup:
Copy-Item "$env:USERPROFILE\.claude\settings.backup.json" "$env:USERPROFILE\.claude\settings.json" -Force
Если backup не делали, откройте файл:
notepad "$env:USERPROFILE\.claude\settings.json"
Удалите строки с:
ANTHROPIC_BASE_URL ANTHROPIC_API_KEY ANTHROPIC_CUSTOM_HEADERS
Сохраните файл и запустите:
claude
Если нужно снова войти в обычный Claude-аккаунт:
/login
31. Финальная шпаргалка
Главный Base URL:
https://claude-code-cli.vibecode-claude.online
Постоянная настройка:
~/.claude/settings.json
Первый тест:
Reply exactly: OK Do not edit files.
Открыть выбор модели:
/model
Проверить статус:
/status
Dashboard:
https://claude-code-cli.vibecode-claude.online/dashboard
AI Assistant:
правый нижний угол dashboard
Перенос баланса:
Dashboard → Transfer balance from any key to your current one
Если что-то не работает - проверьте:
1. Версия Claude Code 2.1.150+ 2. Правильный Base URL 3. Правильно вставлен API key 4. Нажали Yes при вопросе про API key 5. Нет старых конфликтующих настроек 6. При проблемах с сетью попробуйте VPN
32. Главное
Если коротко:
Claude Code API 2.0 работает через Claude Code CLI. Главный URL: https://claude-code-cli.vibecode-claude.online Для постоянного подключения используйте: ~/.claude/settings.json Для проверки: Reply exactly: OK Do not edit files.
Если Claude ответил OK - можно работать.