TokiLabsDocs
Настройка ОС

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

Для популярных дистрибутивов — Ubuntu, Debian, Fedora, Arch и др., а также для WSL и удалённых серверов. Инструкции даны для bash.

Один ключ работает со всеми моделями. Ключ хранится только в вашем браузере и никуда не отправляется.
Ещё нет ключа? Сначала создайте его в разделе Получение API-ключа.

1. Откройте терминал

В графической среде откройте терминал сочетанием Ctrl + Alt + T; на сервере просто подключитесь по SSH. Все команды ниже выполняются от обычного пользователя, sudo не требуется (кроме установки Node.js).

2. Установите Node.js

Нужен Node.js версии 18 и выше. Node из репозиториев дистрибутива часто слишком старый, поэтому рекомендуем nvm — он не требует прав root:

Terminal · nvm (Рекомендуется)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
Terminal
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
Если Node установлен системным менеджером пакетов, для npm install -g может понадобиться sudo. С nvm такой проблемы нет.

3. Задайте переменные среды

Задайте две переменные ниже; адрес API — https://api.tokilabs.xyz.

ПеременнаяЗначениеДля чего
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code, Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-your-keyClaude Code
Terminal · bash
cat >> ~/.bashrc <<'EOF'

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
EOF
source ~/.bashrc

Проверка применения

Если вы используете zsh, замените ~/.bashrc на ~/.zshrc; в fish используйте запись вида set -Ux ANTHROPIC_BASE_URL https://api.tokilabs.xyz.
Terminal
echo $ANTHROPIC_BASE_URL

4. Проверьте соединение

Если вернулся JSON со списком моделей, содержащий "data", адрес и ключ указаны верно.

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
Ответ 401 означает, что ключ неверен или недействителен; при тайм-ауте проверьте настройки прокси на компьютере, см. Частые вопросы.

5. Установите Claude Code

Terminal · Официальный скрипт установки
curl -fsSL https://claude.ai/install.sh | bash

Или установите через npm:

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

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

Terminal
[ -f ~/.claude.json ] || echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

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

Terminal
cd your-project
claude

После запуска введите /status: если Base URL равен https://api.tokilabs.xyz, запросы идут через Toki Labs. Командой /model можно сменить модель, например на claude-opus-5-5. Другие настройки — в разделе Подробная настройка Claude Code.

Серверы и Docker

Для cron-задач и служб systemd файл ~/.bashrc не загружается. Используйте Environment= в unit-файле или передавайте переменные в Docker через -e:

Terminal
docker run --rm \
  -e ANTHROPIC_BASE_URL=https://api.tokilabs.xyz \
  -e ANTHROPIC_AUTH_TOKEN=sk-your-key \
  your-image

Откат настроек

Если вы больше не используете сервис, удалите эти переменные среды, чтобы вернуть настройки по умолчанию:

Terminal
# Откройте ~/.bashrc в редакторе, удалите 2 строки export под «# Toki Labs · Claude», затем:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN