Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Руководство по развёртыванию Claude Code

Установка, инициализация, подключение через прокси, распространённые ошибки и полный процесс развёртывания.

Сначала ознакомьтесь с официальной документацией: docs.claude.com

📋 Предварительные требования
Сначала установите Node.js и убедитесь, что Node.js 18+ установлен правильно.

⚡ Перед первым запуском: как обойти ошибку инициализации

При использовании промежуточного сервиса во время первого запуска Claude Code появится следующая ошибка:

На изображении показана ошибка при первом запуске Claude Code. На чёрном фоне отображается красный и белый текст. После сообщения «Welcome to Claude Code» следуют «Unable to connect to Anthropic services» и «Failed to connect to api.anthropic.com: ERR_BAD_REQUEST», а также рекомендация проверить подключение к интернету и настройки сети. В конце указано, что Claude Code может быть недоступен в вашей стране, и приведена ссылка на официальный сайт. Изображение наглядно показывает ошибку, возникающую при первом запуске Claude Code.На изображении показана ошибка при первом запуске Claude Code. На чёрном…

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Это происходит потому, что при первом запуске Claude Code пытается подключиться к официальному API для подтверждения инициализации, а промежуточный сервис не позволяет пройти этот этап. После установки, но до первого запуска выполните один из следующих способов обхода:

Способ первый: обход с помощью CC-Switch (рекомендуется)

На странице загрузки CC-Switch скачайте последнюю версию установочного пакета для macOS или Windows. Откройте инструмент настройки CC-Switch, перейдите в «Настройки» → «Общие» и включите параметр «Пропустить первоначальное подтверждение установки Claude Code».

На изображении показана вкладка «Общие» на странице настроек CC-Switch. Среди нескольких параметров красной рамкой выделен включённый параметр «Пропустить первоначальное подтверждение установки Claude Code». Изображение относится к разделу «Способ первый: обход с помощью CC-Switch (рекомендуется)» и показывает, как после установки, но до первого запуска открыть CC-Switch, перейти в «Настройки» → «Общие» и включить этот параметр.На изображении показана вкладка «Общие» на странице настроек CC-Switch.…

Способ второй: ручное изменение файла конфигурации

Найдите файл ~/.claude.json в домашнем каталоге пользователя и добавьте в конце поле "hasCompletedOnboarding": true:

⚠️ Соблюдайте формат JSON
Перед добавлением поля поставьте запятую в конце предыдущего поля, иначе ошибка формата JSON не позволит запустить Claude Code.
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "2025-07-14T06:11:03.877Z",
"userID": "xxxx",
"projects": {
"/home/your-user": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true
}

Сохраните изменения и снова запустите claude — теперь он должен работать нормально.

Источник: Как пропустить подтверждение инициализации Claude Code

🚀 Быстрая настройка с помощью CC-Switch (рекомендуется)

Если у вас установлен инструмент быстрой настройки CC-Switch, вы можете легко управлять конфигурацией Claude Code через графический интерфейс без ручного редактирования файлов конфигурации и переменных окружения.

Преимущества CC-Switch

  • Простой и понятный графический интерфейс
  • Переключение конфигураций разных поставщиков одним нажатием
  • Автоматическое управление переменными окружения и файлами конфигурации
  • Резервное копирование и восстановление конфигураций
  • Переключение конфигураций без перезапуска терминала

Шаги настройки

  1. Запустите CC-Switch и добавьте конфигурацию Claude Code

На изображении показан интерфейс добавления новой конфигурации в CC-Switch. Вверху расположены вкладки «Поставщик Claude» и «Единый поставщик»; выбрана вкладка «Поставщик Claude». Ниже находятся разделы «Предустановленные поставщики» и «Пользовательская конфигурация», причём последний выделен красной рамкой. Изображение относится к шагу «Запустите CC-Switch и добавьте конфигурацию Claude Code» и показывает, где выбрать пользовательскую конфигурацию.На изображении показан интерфейс добавления новой конфигурации в CC-Swit…

  • Откройте приложение CC-Switch
  • Перейдите на вкладку «Claude» вверху
  • Нажмите оранжевую кнопку «+» в правом верхнем углу, чтобы добавить новую конфигурацию

На изображении показан интерфейс добавления новой конфигурации в CC-Switch. В поле «API Key» значение скрыто; подсказка сообщает, что это предоставленный службой поддержки ключ, начинающийся с «sk». В поле «Адрес запроса» указано «https://gpt-agent.cc», а жёлтая подсказка рекомендует вводить адрес конечной точки сервиса, совместимого с Claude API, без косой черты в конце. Изображение относится к шагу «Заполните сведения о поставщике» и наглядно показывает пример заполнения API Key и адреса запроса.На изображении показан интерфейс добавления новой конфигурации в CC-Swit…

  1. Заполните сведения о поставщике
  • Название поставщика: произвольное название (например, "guizhou")
  • API Base URL: введите https://api.llm-token.cn
  • API Key: вставьте полученный на платформе специальный ключ-токен Claude
  • Выбор модели: выберите доступную модель Claude в соответствии с вашими задачами
  • Нажмите кнопку «Сохранить»
💡 Подсказка
  • Можно добавить несколько конфигураций разных поставщиков (например, официальную, Guizhou☁️ и другие)
  • CC-Switch автоматически изменяет файл конфигурации ~/.claude/settings.json
  • После переключения конфигурации закройте и перезапустите Claude Code, чтобы изменения вступили в силу
  1. Активируйте и используйте конфигурацию
  • Найдите только что созданную конфигурацию «gptagent» в списке
  • Нажмите кнопку «Используется сейчас» справа от конфигурации (или просто нажмите карточку конфигурации)
  • Конфигурация получит статус «Используется сейчас» (зелёная метка)
  • Перезапустите Claude Code, чтобы новая конфигурация вступила в силу
  1. Быстрое переключение через системный трей

CC-Switch позволяет быстро переключать конфигурации через системный трей:

  • Щёлкните правой кнопкой мыши значок CC-Switch в системном трее
  • В меню выберите категорию Claude
  • Выберите нужную конфигурацию
  • Конфигурация сразу вступит в силу без открытия главного окна
⚠️ Важно
  • После переключения конфигурации необходимо перезапустить Claude Code, чтобы изменения вступили в силу
  • В CC-Switch можно проверить скорость конечных точек API и выбрать оптимальную конфигурацию

Не удаётся общаться в чате после настройки?

Попробуйте сделать следующее. Если это не поможет, обратитесь в службу поддержки.

На изображении показан интерфейс CC Switch: вверху расположен заголовок «CC Switch» и несколько значков. Красная стрелка указывает на пункт «Облачные вычисления Guizhou», справа от которого отображается адрес «https://gpt-agent.cc/» и сообщение «Ошибка запроса». Изображение относится к разделу «Не удаётся общаться в чате после настройки? Попробуйте сделать следующее. Если это не поможет, обратитесь в службу поддержки» и показывает, где можно проверить этот пункт при проблемах с конфигурацией.На изображении показан интерфейс CC Switch: вверху расположен заголовок…

На изображении показаны настройки CC Switch на вкладке «Прокси». Состояние «Локального прокси» — «Работает», на него указывает синяя стрелка. Также видны параметры «Автоматическое переключение при сбое», «Выпрямитель» и «Глобальный исходящий прокси». Изображение относится к разделу «Не удаётся общаться в чате после настройки? Попробуйте сделать следующее. Если это не поможет, обратитесь в службу поддержки» и помогает проверить состояние прокси-сервиса CC Switch для диагностики проблем с конфигурацией.На изображении показаны настройки CC Switch на вкладке «Прокси». Состоян…

На изображении показано содержимое вкладки «Код» на странице настроек из руководства по развёртыванию Claude Code. Вверху видны пункты «Вернуться на главную» и «О программе». Основные сведения: в локальном прокси для версий популярных языков можно выбрать модель соответствующей версии для локальной разработки; прокси включён; в разделе кода модель Claude включена, а модели Codex и Gemini выключены; также доступны настройки адреса API, ключа API и журналирования приложения, причём журналирование включено. Изображение связано с решением проблем с чатом после настройки и наглядно показывает состояние параметров на странице.На изображении показано содержимое вкладки «Код» на странице настроек из…

⌨️ Ручная настройка через командную строку

Если вы не используете CC-Switch, Claude Code можно настроить вручную через командную строку.

🖥️ Windows

Системные требования

Windows 10, 11

Установка

Способ первый: Native Install (рекомендуется)

С помощью PowerShell:

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

С помощью CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Способ второй: установка через NPM (не рекомендуется)

⚠️ Установка через npm не рекомендуется
Обновления в канале npm выходят с задержкой, поэтому установленная версия обычно устарела. Рекомендуем использовать способ Native, описанный выше.
npm install -g @anthropic-ai/claude-code

Проверка установки:

claude --version

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

Для PowerShell:

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.llm-token.cn", "User")

Для CMD:

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.llm-token.cn"
💡 Подсказка
Замените sk-xxx своим персональным ключом! После настройки перезапустите терминал, чтобы переменные окружения вступили в силу.
  • Запуск Claude

В терминале перейдите в каталог проекта (с помощью cd) или оставайтесь в любом каталоге, затем введите команду claude для запуска.

🍏 macOS

Системные требования

MacOS 10.15 (Catalina) или более поздняя версия

Установка

Способ первый: Homebrew (рекомендуется)

brew install --cask claude-code

Способ второй: Curl Script

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

Способ третий: установка через NPM (не рекомендуется)

⚠️ Установка через npm не рекомендуется
Обновления в канале npm выходят с задержкой, поэтому установленная версия обычно устарела. Рекомендуем использовать способ Native, описанный выше.
npm install -g @anthropic-ai/claude-code

Проверка установки

claude -v

При нормальной работе вывод будет выглядеть примерно так: 1.0.108 (Claude Code)

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

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Подсказка
Замените sk-xxx своим персональным ключом!

Перезапуск терминала и запуск Claude

Перезапустите терминал, перейдите в каталог проекта (с помощью cd) или оставайтесь в любом каталоге, затем введите команду claude для запуска.

🐧 Linux

Системные требования

Дистрибутив Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+ и другие)

Установка

Способ первый: Curl Script (рекомендуется)

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

Способ второй: установка через NPM (не рекомендуется)

⚠️ Установка через npm не рекомендуется
Обновления в канале npm выходят с задержкой, поэтому установленная версия обычно устарела. Рекомендуем использовать способ Native, описанный выше.
npm install -g @anthropic-ai/claude-code

Проверка установки

claude -v

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

Ubuntu/Debian (Bash)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.bashrc
source ~/.bashrc

Fedora/CentOS (Zsh)

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 Подсказка
Замените sk-xxx своим персональным ключом!

Перезапуск терминала и запуск Claude

Перезапустите терминал, перейдите в каталог проекта (с помощью cd) или оставайтесь в любом каталоге, затем введите команду claude для запуска.

Частые вопросы

Команда не найдена?

  • Убедитесь, что Claude Code установлен правильно
  • Проверьте переменную окружения PATH
  • Перезапустите окно терминала

Не удаётся подключиться?

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

Руководство по настройке Cherry Studio

Снимки экрана показывают, где указать собственного провайдера, Base URL и API Key.

Руководство по развертыванию Codex

Установка CLI-инструмента, подключение API и настройка среды разработки.

Разделы страницы

⚡ Перед первым запуском: как обойти ошибку инициализацииСпособ первый: обход с помощью CC-Switch (рекомендуется)Способ второй: ручное изменение файла конфигурации🚀 Быстрая настройка с помощью CC-Switch (рекомендуется)Преимущества CC-SwitchШаги настройкиНе удаётся общаться в чате после настройки?⌨️ Ручная настройка через командную строку🖥️ WindowsСистемные требованияУстановкаНастройка переменных окружения🍏 macOSСистемные требованияУстановкаПроверка установкиНастройка переменных окруженияПерезапуск терминала и запуск Claude🐧 LinuxСистемные требованияУстановкаПроверка установкиНастройка переменных окруженияПерезапуск терминала и запуск ClaudeЧастые вопросыКоманда не найдена?Не удаётся подключиться?