Claude Code на Linux

Установка и настройка Claude Code на Linux и WSL: ключ claud.sale, модели, терминал и VS Code.

Настройте Claude Code для работы с проектами через claud.sale. Инструкция подходит для Linux и Linux-окружения WSL. Подготовьте API-ключ группы claude_max и положительный баланс в личном кабинете.

Перед началом

Нужна 64-битная система x64/ARM64, минимум 4 ГБ памяти и доступ в интернет. В официальном списке есть Ubuntu 20.04+, Debian 10+ и Alpine 3.19+. Для установки нужны Bash, curl и сертификаты системы; наш скрипт настройки также использует python3. В Ubuntu/Debian зависимости можно поставить так:

sudo apt update
sudo apt install curl ca-certificates git python3

Для других дистрибутивов используйте свой менеджер пакетов. Команды установки самого Claude Code ниже запускаются от вашего обычного пользователя. Официальные требования.

1. Установите официальный CLI

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

Откройте новый терминал и проверьте установку:

claude --version
claude doctor

Для native-установки Node.js не требуется. Если команда не найдена, проверьте путь:

export PATH="$HOME/.local/bin:$PATH"
claude --version

Чтобы сохранить PATH, добавьте строку export PATH="$HOME/.local/bin:$PATH" в ~/.bashrc для Bash или ~/.zshrc для Zsh.

Alpine Linux

Перед установкой понадобятся дополнительные пакеты:

sudo apk add bash curl ca-certificates python3 libgcc libstdc++ ripgrep

Если в вашей установке Alpine нет sudo, поставьте зависимости через принятый у вас способ администрирования. Добавьте "USE_BUILTIN_RIPGREP": "0" в блок env настроек Claude Code. Подробнее — настройка Alpine.

2. Подключите ключ claud.sale

Войдите или зарегистрируйтесь на claud.sale. На странице API-ключей создайте ключ для claude_max. Замените api_key в команде на этот ключ и выполните блок целиком. Можно также войти и скопировать команду с ключом на главной и скопировать готовую команду:

export ANTHROPIC_AUTH_TOKEN='api_key'; setup=$(mktemp) && curl -fsSL https://claud.sale/install/claude.sh -o "$setup" && bash "$setup"

После успешной настройки откройте новый терминал. При запуске VS Code из терминала тоже используйте новое окно: так редактор получит переменные подключения.

Скрипт сохраняет прежние настройки в ~/.claude/claudsale-backups, записывает защищённый файл ~/.claude/claudsale.env и подключает его в профилях Bash/Zsh. Если задан CLAUDE_CONFIG_DIR, файлы находятся в этом каталоге. Старые ANTHROPIC_API_KEY, ANTHROPIC_MODEL и переключатели Bedrock/Vertex/Foundry убираются из управляемого подключения после создания копии.

Скрипт настраивает существующий Claude Code. Ключ из команды передаётся через ANTHROPIC_AUTH_TOKEN; повторного запроса ключа не будет. Для смены ключа подставьте новое значение вместо api_key и повторите блок подключения. Посмотреть скрипт.

Ключ сохраняется локально; передавать его через URL не нужно. Для GPT/Codex создаётся отдельный ключ группы codex_pro.

Ручная настройка через файл

По умолчанию настройки пользователя находятся в ~/.claude/settings.json. При заданном CLAUDE_CONFIG_DIR в ручных командах используйте его каталог. Перед правкой сделайте копию существующего файла:

mkdir -p "$HOME/.claude"
if [ -f "$HOME/.claude/settings.json" ]; then
  cp -p "$HOME/.claude/settings.json" \
    "$HOME/.claude/settings.json.before-claud-sale-$(date +%Y%m%d-%H%M%S).bak"
fi

Откройте файл своим текстовым редактором. В новый файл вставьте пример; в существующий аккуратно добавьте поля, сохранив остальные настройки. Замените ВАШ_CLAUDE_КЛЮЧ:

{
  "model": "opus",
  "env": {
    "ANTHROPIC_BASE_URL": "https://claud.sale",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_CLAUDE_КЛЮЧ",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

После сохранения ограничьте доступ к файлу, содержащему ключ:

chmod 600 "$HOME/.claude/settings.json"

Если раньше использовали другой сервис, уберите его ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN и конфликтующий apiKeyHelper из настроек подключения. Для текущего терминала:

unset ANTHROPIC_API_KEY CLAUDE_CODE_OAUTH_TOKEN

Проверьте также ~/.bashrc, ~/.zshrc и конфигурацию конкретного проекта. Не добавляйте ключ в общий файл .claude/settings.json репозитория. Файлы и области действия настроек.

3. Запустите и проверьте

Откройте знакомый проект:

cd /путь/к/проекту
claude --model opus

После подтверждения доверия папке введите /status. Убедитесь, что указан адрес https://claud.sale и используется ANTHROPIC_AUTH_TOKEN. Напишите: «Ответь одним словом: готово. Файлы не меняй».

Проверьте завершённый ответ и запись в истории использования claud.sale. Проверочные запросы оплачиваются по обычному тарифу. Фактический расход и баланс смотрите в личном кабинете; локальная оценка стоимости CLI может использовать другие ставки.

Если клиент просит войти в Anthropic, проверьте путь к settings.json, пользователя, от которого запущен процесс, и переменную CLAUDE_CONFIG_DIR: она может переносить каталог конфигурации. Для gateway-подключения должны быть заданы и адрес, и ключ. Проверка подключения по официальной инструкции.

Модели и повседневная работа

Команда в сессии	Модель после настройки
`/model fable`	`claude-fable-5-1`
`/model claude-fable-5`	`claude-fable-5`
`/model claude-opus-4-8`	`claude-opus-4-8`
`/model opus`	`claude-opus-5`
`/model sonnet`	`claude-sonnet-5`
`/model haiku`	`claude-haiku-4-5-20251001`

Через /model можно открыть выбор. Точное имя для одного запуска: claude --model claude-sonnet-5. Если выбор сбрасывается, проверьте ANTHROPIC_MODEL и настройки проекта. Доступность конкретной модели проверяется запросом: наличие имени в меню само по себе её не подтверждает. Правила выбора моделей.

Длинная история увеличивает объём повторно отправляемого контекста. Для отдельной задачи начинайте новую сессию; при необходимости используйте /compact. Чтение кэша на claud.sale имеет отдельную ставку — смотрите цены и пример расчёта.

Панель Claude Code в VS Code

Установите расширение Claude Code от Anthropic (anthropic.claude-code) через Ctrl+Shift+X. В палитре Ctrl+Shift+P выполните Preferences: Open User Settings (JSON) и добавьте:

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://claud.sale" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ВАШ_CLAUDE_КЛЮЧ" }
  ]
}

Существующие настройки сохраните. Общий файл ~/.claude/settings.json содержит привязки моделей; блок выше даёт расширению ключ уже при проверке входа. Выполните Developer: Reload Window, затем Claude Code: Open in New Tab.

Храните ключ в пользовательских настройках, а не в .vscode/settings.json проекта. При использовании Settings Sync учитывайте, что настройки с ключом могут переноситься между устройствами. Для SSH/WSL расширение и CLI должны работать в нужном удалённом окружении; проверьте /status именно там. Также можно запустить claude во встроенном терминале VS Code. Официальная конфигурация расширения.

Диагностика

Проблема	Действие
`command not found: claude`	Проверьте `~/.local/bin/claude`, обновите PATH и откройте новый терминал.
`Permission denied`	Убедитесь, что домашняя папка и конфигурация принадлежат вашему пользователю. Проверьте `claude doctor`.
Ошибка JSON	В `settings.json` нужны двойные кавычки; уберите комментарии и запятую после последнего поля.
Используется старый Bedrock, Vertex или Foundry	Проверьте `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` и `CLAUDE_CODE_USE_FOUNDRY` в профиле оболочки и блоках `env` клиента, проекта и расширения. Уберите прежние включающие значения для подключения к claud.sale, откройте новый терминал и проверьте маршрут через `/status`.
`401`	Перепроверьте ключ и его статус, уберите пробелы при копировании.
`403` / недостаточно средств	Проверьте `claude_max`, баланс и лимиты ключа. Сохраните время и текст ошибки для разбора.
`404` / неизвестная модель	Адрес должен быть без `/v1`; выберите точный идентификатор из таблицы.
`429`, `502`, `503`, таймаут	Проверьте короткую новую сессию после завершения текущей попытки. При повторении откройте общую диагностику.
Ошибка сертификата	Обновите системные сертификаты. Для корпоративной сети настройте доверенный CA согласно её требованиям.

Номер версии и расположение запускаемой команды:

claude --version
command -v claude
claude doctor

Ключи и полный конфигурационный файл публиковать для диагностики не нужно. Достаточно версии клиента, ОС, модели, времени запроса и текста ошибки со скрытыми секретами. Диагностика установки; ошибки Claude Code.

Обновление, смена ключа и откат

claude update
claude --version

Для native-установки работают и фоновые обновления. Чтобы заменить ключ, повторите скрипт настройки с новым значением; обновите его также в пользовательских настройках VS Code и начните новую сессию.

Для отмены автоматической настройки закройте Claude Code и VS Code и восстановите последний снимок:

bash "$HOME/claud-sale-claude.sh" --restore

Восстанавливается состояние перед последним применением. Текущие файлы перед заменой также сохраняются. Если настраивали сервис несколько раз, последний снимок может содержать предыдущее подключение к claud.sale.

Файл settings.json откатывается целиком, поэтому поздние правки при необходимости перенесите из копии before-restore. В профилях оболочки восстанавливается только блок Claude Code; соседние настройки и блок подключения Codex сохраняются.

При ручной настройке восстановите сохранённую до изменений копию ~/.claude/settings.json. Отдельно уберите добавленные поля claudeCode.environmentVariables и claudeCode.disableLoginPrompt из настроек VS Code. Удалите добавленные вручную переменные из профиля оболочки и откройте новый терминал. Для текущего терминала:

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL
unset ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL
unset ANTHROPIC_DEFAULT_FABLE_MODEL CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY

Если до подключения файла не было, удалите только добавленные поля из env и выбранную нами модель, сохранив остальные настройки. После удаления gateway-ключа клиент может снова использовать сохранённую авторизацию Anthropic.

Удаление native-установки

Закройте клиент, затем удалите его исполняемый файл и установленные версии:

rm -f "$HOME/.local/bin/claude"
rm -rf "$HOME/.local/share/claude"

Настройки и история в ~/.claude сохраняются. Расширение удаляется отдельно через VS Code. Если Claude Code установлен пакетным менеджером, используйте команду удаления для вашего способа установки.

Официальные источники

Сверено 9 сентября 2026 года: установка, gateway-подключение, настройки, модели, VS Code.