Claude Code

Claude Code — инструмент программирования в терминале от Anthropic. Настроив адрес API, ключ API и ID модели, вы можете использовать в Claude Code совместимую точку входа Anthropic Messages платформы AGTCloud.

В этом руководстве рассматривается только Claude Code CLI. Поддержка вызова инструментов, расширенного мышления и экспериментальных функций зависит от модели. Выбирайте модель, доступную текущему ключу API и поддерживающую Anthropic Messages.

Подготовка

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

Подготовили терминал и Git;
Зарегистрировались и вошли в AGTCloud;
Создали токен на странице API Keys;
Нашли в каталоге моделей ID модели протокола Anthropic, доступной текущему токену.

Установка Claude Code

Выберите способ установки для своей ОС. Нативный установочный скрипт обеспечивает автоматическое обновление; при установке через Homebrew и WinGet обновляйте программу вручную через соответствующий менеджер пакетов.

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

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

claude --version
claude doctor

claude doctor проверяет установку и конфигурационные файлы. Если терминал не находит claude, откройте его заново и убедитесь, что каталог установки добавлен в PATH.

Настройка AGTCloud

Claude Code отправляет запросы по адресу ANTHROPIC_BASE_URL. Укажите только API Origin AGTCloud без завершающего /v1: Claude Code самостоятельно обращается к /v1/messages.

Временная конфигурация

Следующие настройки действуют только в текущем сеансе терминала. Замените your-api-key и MODEL_ID своим токеном и ID модели.

unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

Переменная окружения	Назначение
`ANTHROPIC_BASE_URL`	Направляет запросы Claude Code на адрес API AGTCloud, показанный на этой странице
`ANTHROPIC_API_KEY`	Передаёт ключ API AGTCloud через Header `X-Api-Key`
`ANTHROPIC_MODEL`	Задаёт ID модели по умолчанию для текущего сеанса

Удалите конфликтующие переменные аутентификации

Если в системе задан ANTHROPIC_AUTH_TOKEN, Claude Code использует его как Bearer Token, что может переопределить ANTHROPIC_API_KEY. Перед применением этой конфигурации удалите конфликтующую переменную.

Постоянная конфигурация

Для автоматического применения при каждом открытии терминала запишите те же настройки в конфигурацию shell или пользовательские переменные окружения Windows. Ключ API сохраняется локально открытым текстом; используйте этот способ только на личном доверенном устройстве.

Откройте ~/.zshrc и добавьте:

export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

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

source ~/.zshrc

Выбор модели

MODEL_ID — место для замены, а не настоящее название модели. Скопируйте из каталога моделей ID модели, доступной текущему ключу API и поддерживающей Anthropic Messages.

В Claude Code можно выполнить /model, чтобы просмотреть или сменить модель текущего сеанса. Автоматическое отображение всех моделей AGTCloud зависит от версии Claude Code и ключа API. Если нужной модели нет, задайте её ID через ANTHROPIC_MODEL.

Запуск и проверка подключения

Переход в каталог проекта

cd /path/to/your/project

Запуск Claude Code

claude

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

Проверка текущей конфигурации

Выполните в Claude Code:

/status

Убедитесь, что источником аутентификации является ключ API, а Base URL соответствует адресу API AGTCloud на этой странице. Base URL не должен содержать повторяющийся /v1.

Тест только для чтения

В тестовом проекте с README.md введите:

Прочитайте README.md и в трёх пунктах опишите назначение этого проекта. Не изменяйте никакие файлы.

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

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

Частые вопросы

Симптом	Что проверить сначала	Решение
Команда `claude` не найдена	Установку и `PATH`	Откройте терминал заново, выполните `claude doctor` и при необходимости повторите официальную команду установки
После запуска по-прежнему требуется вход	Действует ли ключ API в том же терминале, где запускается Claude Code	Проверьте `ANTHROPIC_API_KEY`, откройте терминал заново и повторите запуск
Ключ API не применяется	Не задан ли также `ANTHROPIC_AUTH_TOKEN`	Удалите конфликтующую переменную и проверьте источник аутентификации через `/status`
Ответ `401`	Ключ API, переменные окружения и состояние токена	Скопируйте действующий ключ API заново и подтвердите источник аутентификации через `/status`
Ответ `403`	Права токена, доступ к модели и состояние аккаунта	Проверьте токен и доступные модели в консоли
Ответ `404`	Base URL и ID модели	Укажите только `https://api.agtcloud.cn` без `/v1` и скопируйте ID модели заново
Модель не найдена или недоступна	Модели, видимые текущему ключу API, и поддержку протокола	Выберите модель с Anthropic Messages и задайте полный ID через `ANTHROPIC_MODEL`
Некоторые инструменты или расширенные функции недоступны	Возможности модели и совместимость шлюза	Сначала проверьте обычный диалог; расширенные возможности зависят от выбранной модели и текущей адаптации

Если причину найти не удаётся, запишите время запроса, ID модели, HTTP-статус и обезличенную ошибку, затем обратитесь к разделу ошибок и диагностики. Не отправляйте полный ключ API.