🪄 Интеграция Claude Code с пользовательскими моделями CodingPlanX

Claude Code — это мощный ИИ-ассистент для программирования, выпущенный компанией Anthropic. Он встраивается прямо в ваш терминал, понимает вашу кодовую базу и беспрепятственно сотрудничает с вами при написании, рефакторинге и отладке кода.

Это руководство проведет вас через подготовку среды, установку инструментов и специальную настройку для прокси-интерфейса codingplanx.ai.

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

Перед началом убедитесь, что ваша система соответствует следующим минимальным требованиям:

Node.js: Версия >= 18.0
Операционная система: macOS, Linux, Windows (рекомендуется WSL)

🚀 Быстрый старт

1. Установка Node.js

💡 Совет: Если у вас уже установлен Node.js версии 18.0 или выше, пропустите этот шаг.

🍎 Пользователи macOS

Рекомендуется установка через Homebrew:

# 1. Установка инструментов командной строки Xcode
sudo xcode-select --install

# 2. Установка Homebrew (если еще не установлен)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Установка Node.js через Homebrew
brew install node

# 4. Проверка установки
node --version

🐧 Пользователи Ubuntu / Debian

Используйте официальный скрипт NodeSource для установки LTS-версии:

# 1. Загрузка и запуск установочного скрипта
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. Установка Node.js
sudo apt-get install -y nodejs

# 3. Проверка установки
node --version

🪟 Пользователи Windows

Рекомендуется использовать командную строку winget для установки или перейти на Официальный сайт Node.js для загрузки установщика:

# Установка LTS-версии Node.js с помощью winget
winget install OpenJS.NodeJS.LTS

# Проверка установки (после установки может потребоваться перезапуск терминала)
node --version

2. Установка Claude Code

Откройте терминал и используйте npm для глобальной установки Claude Code:

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

# Проверка успешности установки
claude --version

(Примечание: Если вы столкнулись с ошибками прав доступа, пользователям macOS/Linux может потребоваться использовать sudo npm install -g @anthropic-ai/claude-code)

3. Настройка и начало использования

🔑 Получение необходимой информации для настройки

Для использования этого сервиса вам необходимо подготовить следующие две переменные окружения:

Настройка	Описание	Как получить
`ANTHROPIC_AUTH_TOKEN`	Токен авторизации API	После регистрации перейдите на страницу API Tokens и нажмите Add Token (Начинается с `sk-`)
`ANTHROPIC_BASE_URL`	Адрес сервиса API	Введите точно: `https://api.codingplanx.ai`

📝 Рекомендации при создании токена:

Name (Имя): Назовите как угодно (например, claude-code-cli)

Quota (Квота): Установите Unlimited Quota (Безлимитно)

Group (Группа): Выберите Claude code exclusive или Official Claude 3 & above Proxy

Другие опции: Оставьте настройки по умолчанию

💻 Запуск Claude Code

Пожалуйста, выберите соответствующую команду запуска в зависимости от вашей операционной системы и терминала. Сначала перейдите в каталог вашего проекта:

cd your-project-folder

🟢 Linux / macOS (Bash/Zsh)

# Установка переменных окружения (действует для текущего сеанса терминала)
export ANTHROPIC_AUTH_TOKEN="sk-YourActualToken"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # Установка тайм-аута в 300 секунд для предотвращения разрывов при длинных ответах

# Запуск Claude Code
claude

🔵 Windows PowerShell

# Установка переменных окружения (действует для текущего сеанса терминала)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YourActualToken"
$env:API_TIMEOUT_MS = "300000"

# Запуск Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-YourActualToken
set API_TIMEOUT_MS=300000

claude

💡 Профессиональный совет: Если вы не хотите вводить переменные окружения каждый раз, вы можете добавить операторы export выше в ваш файл ~/.bashrc или ~/.zshrc (Mac/Linux) или добавить постоянные переменные окружения в настройках системы Windows.

⚙️ Мастер настройки при первом запуске

При первом запуске claude система проведет вас через базовые настройки:

Theme (Тема) 👉 Выберите предпочитаемую цветовую схему терминала, нажмите Enter для подтверждения.
Safety (Безопасность) 👉 Прочтите и подтвердите предупреждения о безопасности, нажмите Enter.
Terminal (Терминал) 👉 Рекомендуются настройки по умолчанию, нажмите Enter.
Trust (Доверие) 👉 Подтвердите, что вы доверяете текущему рабочему каталогу, нажмите Enter.

✨ Поздравляем! Когда вы увидите приглашение к вводу, вы можете начать общаться с вашим ИИ-напарником по программированию! Попробуйте написать: "Помоги мне объяснить основную структуру этого проекта".

❓ Часто задаваемые вопросы (FAQ)

В: Возникает ошибка `Invalid API Key · Please run /login`?

О: Это означает, что Claude Code не смог прочитать ваши переменные окружения. Пожалуйста, проверьте:

Правильно ли установлены ANTHROPIC_AUTH_TOKEN и ANTHROPIC_BASE_URL.
Правильный ли формат токена (он должен начинаться с sk- и не содержать лишних пробелов или кавычек).
Если вы настроили постоянные переменные окружения, убедитесь, что вы перезапустили терминал, чтобы они вступили в силу.

В: Почему в левом нижнем углу терминала отображается статус `offline`?

О: По умолчанию Claude Code пингует google.com для проверки состояния сети. В некоторых ограниченных сетевых средах отображение offline является нормальным и никак не повлияет на ваше нормальное использование и генерацию кода.

В: Почему попытка попросить Claude просмотреть веб-страницы (Fetch) завершается ошибкой?

О: Перед доступом к внешним веб-страницам Claude Code необходимо вызвать официальные сервисы для проверки безопасности. Если вы столкнулись с ошибками Fetch:

Убедитесь, что ваш компьютер имеет стабильное международное интернет-соединение.
При необходимости включите глобальный прокси-сервер в терминале (например, export https_proxy=...).

В: Почему запросы всегда выдают `fetch failed` или тайм-аут?

О: Обычно это вызвано колебаниями сети или переадресацией прокси. Решения:

Проверьте, правильно ли установлена переменная окружения тайм-аута: API_TIMEOUT_MS=300000.
Попробуйте сменить локальный узел прокси.
Нажмите Ctrl+C, чтобы выйти из текущего сеанса, и снова запустите команду claude.

В: Ошибка входа через веб?

О: Если вы столкнулись с аномалиями на веб-странице при получении токена, попробуйте очистить кэш файлов Cookie вашего браузера или используйте режим инкогнито для повторного входа в yunwu.ai.

📌 Важные примечания

🛡️ Уведомление об интерфейсе: Этот сайт подключается напрямую к официальному сервису переадресации Claude Code, идеально адаптированному для инструмента CLI.
🚦 Ограничения скорости (Rate Limits): Текущая конфигурация поддерживает только трафик API Claude Code и не поддерживает стандартные вызовы API для других сторонних клиентов.
🔒 Предупреждение о безопасности: Пожалуйста, храните ваш токен API (sk-...) в безопасности. Никогда не жестко кодируйте его в ваших скриптах и не загружайте в публичные репозитории GitHub.