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

📋 Подготовительные шаги

Прежде чем начать, убедитесь, что у вас есть:

Зарегистрированная учетная запись Koze и авторизованный пользователь
Создан ключ API на странице управления API
Установлен Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Шаг 1: Настройка переменных окружения

Выполните следующие команды в терминале, чтобы установить адрес API и ключ в качестве переменных окружения:

# Установите адрес прокси Koze на базовый URL
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Установите ключ API, созданный вами в бэкэнде Koze
export ANTHROPIC_AUTH_TOKEN="Ваш API-ключ"

💡 Совет: Замените https://api.kozeai.com на домен вашего сервиса. Ключи API можно просмотреть или создать на странице «Управление API → Существующие ключи».

🔧 Шаг второй: Настройка плагина VSCode (необязательно)

Если вы используете плагин Claude для VSCode, вам необходимо настроить его в файле `~/.claude/config.json`:

{

"primaryApiKey": "Ваш ключ API",

"apiBaseUrl": "https://api.kozeai.com/v1"

}

Если файл не существует, создайте его вручную.

macOS / Linux: ~/.claude/config.json
Windows: C:\Users\Your Username\.claude\config.json

🎯 Шаг 3: Запуск Claude Code

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

claude

Claude Code автоматически будет использовать адрес прокси Koze, который вы настроили для отправки запросов.

📌 Постоянные переменные окружения

Чтобы избежать сброса переменных каждый раз при открытии терминала, рекомендуется записывать переменные в файл конфигурации оболочки:

# Пользователь Bash

echo 'export' ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >>> ~/.bashrc

source ~/.bashrc

# Пользователь Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >> ~/.zshrc

source ~/.zshrc

✅ Проверка соединения

После запуска Claude Code, если вы видите обычный диалоговый интерфейс, настройка выполнена успешно. Вы можете просмотреть записи звонков в режиме реального времени на странице «Статистика использования» Koze.

⚠️ Часто задаваемые вопросы

Проблема	Решение
Совет: Недействительный ключ API	Проверьте, правильно ли скопирован ключ API, убедитесь, что в нем нет лишних пробелов
Тайм-аут соединения	Убедитесь, что базовый URL-адрес указан правильно и содержит суффикс `/v1`
Модель недоступна	Проверьте список доступных моделей для текущего пакета в лобби модели Koze