Claude Code

Claude Code совместим с протоколом Anthropic: достаточно направить Base URL на aicentos и вставить свой API Key, чтобы получить доступ ко всем моделям Claude, подключённым к aicentos.

Шаг 1: установка Claude CodeКопировать ссылку на якорь

Установка окружения Node.jsКопировать ссылку на якорь

Скачайте актуальную LTS-версию с официального сайта Node.js и выберите установщик под свою операционную систему.

После завершения установки откройте терминал (в Windows — git bash или cmd) и введите:

node -v

Если виден номер версии, установка прошла успешно.

Установка Claude CodeКопировать ссылку на якорь

Перед установкой убедитесь, что окружение Node.js из предыдущего шага уже настроено.

Windows: нажмите Win + R, введите cmd, нажмите Enter, чтобы открыть терминал, и выполните:

npm install -g @anthropic-ai/claude-code

Mac / Linux: выполните в терминале:

npm install -g @anthropic-ai/claude-code

или воспользуйтесь официально рекомендуемым curl-скриптом:

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

После установки проверьте результат:

claude --version

Появление номера версии означает, что установка прошла успешно.

Шаг 2: получение API-ключаКопировать ссылку на якорь

Перейдите в консоль официального сайта aicentos и создайте свой API-ключ.

Подробные шаги создания ключа описаны в разделе Быстрый старт.

Шаг 3: настройка подключенияКопировать ссылку на якорь

Ниже два варианта: централизованное управление через CC Switch (рекомендуется) или ручная настройка.

Вариант 1: CC Switch (рекомендуется)Копировать ссылку на якорь

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

Подробнее: Подключение CC Switch →

Вариант 2: ручная настройкаКопировать ссылку на якорь

Если не хотите ставить дополнительные инструменты, достаточно задать переменные окружения. Три способа на выбор.

Временное действие (текущая сессия терминала)Копировать ссылку на якорь

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

export ANTHROPIC_BASE_URL="https://aicentos.com"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-API-ключ"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude

Если ваша версия не распознаёт ANTHROPIC_AUTH_TOKEN, используйте вместо него:

export ANTHROPIC_API_KEY="sk-ваш-API-ключ"

Постоянное действие (файл конфигурации, рекомендуемый ручной способ)Копировать ссылку на якорь

Отредактируйте ~/.claude/settings.json, записав:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aicentos.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-API-ключ",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Windows: также можно в «Системных переменных окружения», в разделе «Переменные среды пользователя», нажать «Создать» и завести две переменные:

После сохранения перезапустите Claude Code, чтобы изменения вступили в силу.

Запись в конфигурацию shell (глобальное действие)Копировать ссылку на якорь

Добавьте переменные окружения в ~/.zshrc или ~/.bashrc:

nano ~/.zshrc

В конец файла допишите:

# API-ключ aicentos (ключ, созданный на шаге 2)
export ANTHROPIC_AUTH_TOKEN="ваш-ключ"

# Base URL aicentos
export ANTHROPIC_BASE_URL="https://aicentos.com"

Сохраните и выйдите, затем выполните source ~/.zshrc (или откройте новый терминал), чтобы настройки вступили в силу.

Шаг 4: запуск Claude CodeКопировать ссылку на якорь

Перейдите в каталог своего проекта и запустите:

cd /path/to/your/project
claude

Выбор моделиКопировать ссылку на якорь

При запуске укажите конкретную модель через --model:

claude --model claude-opus-4-7

Имена моделей — как в «витрине моделей» консоли aicentos; см. Поддерживаемые модели.

Часто используемые командыКопировать ссылку на якорь

Запуск на телефоне (Termux + Ubuntu)Копировать ссылку на якорь

Подходит для сценариев «компьютера нет под рукой, надо срочно поправить баг в дороге или немного повайбить по пути на работу». Root не нужен, прошивку менять не нужно — всё делается внутри Termux. Весь процесс занимает 10–20 минут в зависимости от скорости сети.

Что вы получитеКопировать ссылку на якорь

• Окружение Ubuntu, работающее прямо в телефоне (не затрагивает систему и почти не занимает места)
• Полновесный консольный инструмент Claude Code (ровно тот же, что и на компьютере)
• Дешёвое подключение через aicentos с мгновенным переключением между Opus / Sonnet / Haiku

ПодготовкаКопировать ссылку на якорь

Нужны всего две вещи:

• Android-смартфон (на iOS Termux не поставить, инструкция к нему не применима)
• Аккаунт aicentos и API Key (пополнить кошелёк →, создать ключ →)

Termux ни в коем случае не устанавливайте из Google Play — та версия давно устарела и не поддерживается, из-за неё не запустятся дальнейшие скрипты. Скачайте свежую версию из F-Droid или со страницы релизов Termux на GitHub.

Шаг 1: установка скрипта tmoe-linux в один кликКопировать ссылку на якорь

Откройте Termux, дождитесь приглашения командной строки (строка ~ $), скопируйте следующую строку целиком и нажмите Enter:

. <(curl -L l.tmoe.me)

Это зеркало специально для материкового Китая; пользователи из других регионов используют . <(curl -L git.io/linux.sh).

После выполнения появится графическое меню примерно такого вида:

Выбор — клавишами громкости вверх/вниз, подтверждение — Enter (или просто коснитесь экрана).

Шаг 2: установка контейнера UbuntuКопировать ссылку на якорь

В меню tmoe последовательно выберите Установить дистрибутив Linux / Install GNU/Linux container — откроется список дистрибутивов:

Настоятельно рекомендуется выбрать Ubuntu (лучшая совместимость, по apt больше всего материалов, и на любую проблему легко найти ответ). Версия — свежая LTS (например, 22.04 / 24.04).

Загрузка и распаковка займут несколько минут в зависимости от скорости сети — просто подождите.

Шаг 3: вход в контейнер и понимание, «где вы находитесь»Копировать ссылку на якорь

После установки вы, скорее всего, попадёте в контейнер автоматически. Именно здесь новички чаще всего теряются, поэтому сначала разберёмся, как это определить:

Вы внутри контейнера Ubuntu (приглашение выглядит примерно так):

Вы всё ещё в Termux и не вошли (приглашение попроще):

Если второе, вернитесь в Termux и введите:

tmoe

Меню откроется снова — найдите пункт Запустить контейнер / Start container и войдите.

Запомните правило: установка Node, установка Claude Code, запуск команды claude — всё это делается только внутри контейнера Ubuntu. Пакетная система pkg самой Termux установить Claude Code не может.

Шаг 4: установка Node.js и Claude CodeКопировать ссылку на якорь

Убедившись, что вы в контейнере Ubuntu, выполните по очереди:

# 1. Обновить индекс пакетов apt
apt update

# 2. Установить Node.js + npm (версий из состава Ubuntu достаточно)
apt install -y nodejs npm

# 3. Установить Claude Code глобально
npm install -g @anthropic-ai/claude-code

Если npm жалуется на права, добавьте sudo перед командой. Если команды sudo вообще нет — значит, вы работаете под root и можно выполнять её напрямую.

Шаг 5: подключение aicentos к Claude CodeКопировать ссылку на якорь

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

Меняем две переменные окружения, чтобы направить его на aicentos:

# 1. Установить текстовый редактор nano (в контейнере его может не быть)
apt install -y nano

# 2. Отредактировать конфигурацию shell
nano ~/.bashrc

Клавишами со стрелками перейдите в самый конец файла и вставьте с новой строки:

export ANTHROPIC_BASE_URL=https://aicentos.com
export ANTHROPIC_AUTH_TOKEN=ваш-api-ключ-от-aicentos.com

Замените ваш-api-ключ-от-aicentos.com на API Key, созданный в консоли aicentos (обычно начинается с sk-).

Получится примерно так:

Сохраните и выйдите:

• Нажмите Ctrl + X (клавиша Ctrl есть на виртуальной клавиатуре Termux по умолчанию)
• На запрос Save нажмите Y
• Затем Enter для подтверждения имени файла

Примените настройки сразу:

source ~/.bashrc

Шаг 6: запускКопировать ссылку на якорь

claude

При первом запуске будет предложено выбрать способ входа:

• Если раньше входили через официальный аккаунт и хотите это сбросить, введите /logout прямо в Claude Code: после выхода снова claude — и будут использованы ваши переменные окружения
• При полностью чистой установке этот шаг может быть пропущен, и сразу будут взяты переменные окружения

Как только появится диалоговое окно Claude Code, всё готово — задайте любой вопрос для проверки:

Привет, напиши мне python-скрипт hello world

Шпаргалка команд для телефонаКопировать ссылку на якорь

Внутри Claude Code:

Вне контейнера (в Termux):

Типичные проблемы на телефонеКопировать ссылку на якорь

1. npm install -g не запускается / зависает

Возможно, дело в сети. В контейнере можно сначала сменить зеркало на китайское: npm config set registry https://registry.npmmirror.com, а затем снова npm install -g @anthropic-ai/claude-code.

2. Команда claude не найдена (not found)

Путь к командам, установленным через npm install -g, не входит в PATH. Добавьте в конец ~/.bashrc:

export PATH="$PATH:$(npm config get prefix)/bin"

Затем source ~/.bashrc.

3. Ошибка 401 / недостаточно средств

Проверьте баланс кошелька aicentos и убедитесь, что ANTHROPIC_AUTH_TOKEN скопирован полностью (без пробелов в начале и конце).

4. Хочется Sonnet, чтобы не жечь деньги на Opus

Войдя в claude, введите /model и выберите sonnet. Либо зафиксируйте модель по умолчанию, добавив в .bashrc строку export ANTHROPIC_MODEL=claude-sonnet-5.

Продвинутые возможности на телефонеКопировать ссылку на якорь

• Для более удобного ввода установите Termux:Styling и смените шрифт и цветовую схему
• Нужен графический интерфейс — в меню tmoe есть рабочий стол VNC, можно запустить полноценные GNOME/XFCE на телефоне
• Для длительной работы в фоне используйте tmux или screen — при закрытии Termux сессия не оборвётся

На этом руководство завершено. Если возникнут вопросы, добро пожаловать в сообщество aicentos с обратной связью.

ПримечанияКопировать ссылку на якорь

• API Key создаётся на странице «API Key» в консоли.
• ANTHROPIC_AUTH_TOKEN и ANTHROPIC_API_KEY — выберите что-то одно, не задавайте оба.
• В Base URL указывайте только корневой адрес https://aicentos.com, не добавляйте вручную /v1/messages — Claude Code соберёт путь сам.
• После изменения конфигурации перезапустите терминал / Claude Code.
• Ни в коем случае не коммитьте API Key в репозиторий кода.