ddshub.cc LogoDDS Hub

Настройка Claude Code

В этом разделе описан полный процесс установки Claude Code CLI на macOS и Windows, а также подключение к ретранслирующему узлу DDShub.

Установка на Mac

Установка Node.js через Brew

Для Claude Code требуется Node.js. Мы рекомендуем использовать Homebrew для управления версиями Node.js.

1

Установить Homebrew

bash
# Скачать и установить Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
2

Установить Node.js

bash
# Скачать и установить Node.js
brew install node

# Проверить версию Node.js
node -v

# Проверить версию NPM
npm -v

Установка Claude Code

Claude Code — официальный CLI-инструмент Anthropic для ИИ-программирования, устанавливается глобально через npm.

1

Глобальная установка Claude Code CLI

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

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

bash
claude --version
# Claude Code x.x.x

Если возникают ошибки прав доступа, добавьте перед командой sudo или настройте глобальный каталог npm в вашем пользовательском каталоге.

3

Запустить проверку состояния

bash
claude doctor

Эта команда проверяет конфигурацию окружения, включая подключение к API.

Совет
Если при установке возникают сетевые проблемы, временно задайте реестр npm: npm config set registry https://registry.npmmirror.com
Внимание
Требуется Claude Code v2.1.68 или выше.

Настройка AUTH_TOKEN & BASE_URL

Настройте ретранслятор API DDShub, чтобы Claude Code подключался к сервисам Anthropic через нашу ускоренную точку доступа.

Примечание
Перед этим шагом убедитесь, что вы зарегистрировались на DDShub и создали API-токен. Если нет, сначала прочитайте раздел "Создание токена и API-ключ".

Способ 1: Переменные окружения (рекомендуется)

Добавьте следующее в конфигурацию вашей оболочки (~/.zshrc или ~/.bashrc):

~/.zshrc
# DDShub - конфигурация ретранслятора Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"   # Замените на ваш API Key
export ANTHROPIC_BASE_URL="https://www.ddshub.cc"

После сохранения перезагрузите конфигурацию:

bash
source ~/.zshrc

# Проверить конфигурацию
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Способ 2: Интерактивный вход

Запустите команду claude напрямую, и CLI проведёт вас через настройку:

bash
claude

# Вам будет предложено ввести:
# > Enter your API key: sk-xxx
# > Enter API base URL (optional): https://www.ddshub.cc
Внимание
Храните ваш API-токен в безопасности. Никогда не коммитьте его в Git и не передавайте другим. При компрометации немедленно отзовите его в панели управления DDShub.

Проверка подключения

После настройки выполните в любом каталоге проекта:

bash
claude "Hello, introduce yourself in one sentence"

# Ожидаемый вывод:
# I am Claude, an AI assistant made by Anthropic.

Установка на Windows

Внимание
Требования: Windows 10 (версия 1809 / сборка 17763) или новее

Установка Node.js через PowerShell

Мы рекомендуем устанавливать Node.js через менеджер пакетов Chocolatey для удобного управления версиями.

1

Откройте PowerShell от имени администратора

Щёлкните правой кнопкой по меню «Пуск» → выберите "Windows PowerShell (Admin)" или "Terminal (Admin)".

2

Установить Chocolatey и Node.js

powershell
# Скачать и установить Chocolatey
powershell -c "irm https://community.chocolatey.org/install.ps1|iex"

# Установить Node.js через Chocolatey
choco install nodejs --version="24.13.0"

# Проверить версию Node.js
node -v

# Проверить версию NPM
npm -v

Установка Claude Code

После установки Node.js установите Claude Code CLI глобально через npm.

1

Глобальная установка Claude Code CLI

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

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

powershell
claude --version
# Claude Code x.x.x

Если возникают ошибки прав доступа, заново откройте PowerShell от имени администратора.

Совет
Если установка через npm идёт медленно, временно смените реестр: npm config set registry https://registry.npmmirror.com
Внимание
Требуется Claude Code v2.1.68 или выше.

Настройка AUTH_TOKEN & BASE_URL

В Windows мы рекомендуем сохранять конфигурацию через системные переменные окружения или PowerShell Profile.

Примечание
Перед этим шагом убедитесь, что вы зарегистрировались на DDShub и создали API-токен. Если нет, сначала прочитайте раздел "Создание токена и API-ключ".

Способ 1: PowerShell Profile (рекомендуется)

Выполните следующее в PowerShell, чтобы открыть файл Profile:

$PROFILE
# Показать путь к Profile
echo $PROFILE

# Редактировать Profile (создаётся, если не существует)
notepad $PROFILE

Добавьте следующее в конец файла и сохраните:

$PROFILE
# DDShub - конфигурация ретранслятора Claude Code
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxx"   # Замените на ваш API Key
$env:ANTHROPIC_BASE_URL   = "https://www.ddshub.cc"

Заново откройте PowerShell, чтобы конфигурация вступила в силу, или выполните сразу:

powershell
. $PROFILE

Способ 2: Системные переменные окружения (GUI)

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

1

Открыть системные переменные окружения

Щёлкните правой кнопкой по "This PC" → "Properties" → "Advanced system settings" → "Environment Variables", или найдите "environment variables" в меню «Пуск».

2

Создать новые пользовательские переменные

В разделе "User variables" нажмите "New" и добавьте:

Имя переменнойЗначение
ANTHROPIC_AUTH_TOKENsk-xxxxxxxx...
ANTHROPIC_BASE_URLhttps://www.ddshub.cc
3

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

powershell
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

Проверка подключения

После настройки выполните в любом каталоге проекта:

powershell
claude "Hello, introduce yourself in one sentence"

# Ожидаемый вывод:
# I am Claude, an AI assistant made by Anthropic.
Внимание
Храните ваш API-токен в безопасности. Никогда не коммитьте его в Git и не передавайте другим. При компрометации немедленно отзовите его в панели управления DDShub.