К основному содержимому

Перемещение пользователей Claude Code CLI

Если ваши разработчики используют Claude Code CLI, настройте его отдельно от настольного приложения. Настольное приложение берет параметры поставщика из конфигурации Claude Desktop на 3P, а не из ANTHROPIC_BASE_URL или settings.json, и передает их в сеансы Code, которые оно запускает. CLI читает переменные окружения, файлы параметров и управляемые параметры Claude Code, которые используют отдельный ключ политики.

Это руководство предназначено для администраторов организаций на планах Claude Enterprise.

Эта статья является частью Переход с Claude Enterprise на Claude Desktop у поставщика облачных услуг, которая определяет термины волна, период перекрытия и дата отключения.

CLI и все, что работает локально, работает у каждого поставщика. После перемещения разработчики входят по-другому, ваши политики достигают их компьютеров по-другому, и некоторые функции недоступны.

Подключите CLI к вашему поставщику

Установите переменные поставщика для Amazon Bedrock, Google Cloud, Microsoft Foundry или шлюза LLM. Разработчикам не требуется вход в браузер claude.ai. С шлюзом установите как базовый URL, так и учетные данные шлюза. Только с базовым URL сохраненный вход claude.ai остается активным учетным данным, поэтому его лимиты и выставление счетов по-прежнему применяются. Перед развертыванием команды закрепите версии вашей модели.

Доставьте политику на каждое устройство

Управляемые сервером параметры не применяются, когда установлен поставщик третьей стороны или пользовательский базовый URL. Переместите эти политики в управляемые параметры на устройстве. Вы можете доставить их как файл managed-settings.json, профиль macOS com.anthropic.claudecode или ключ реестра HKLM\SOFTWARE\Policies\ClaudeCode. Они имеют приоритет над параметрами пользователя и проекта, за исключением нескольких ключей, чувствительных к безопасности, где более строгое значение с более низкого уровня по-прежнему учитывается.

  • Ограничьте, какие поставщики может использовать компьютер: Установите allowedProviders (Claude Code v2.1.285 или позже). Во время периода перекрытия список, такой как ["anthropic", "bedrock"], позволяет разработчикам использовать любой из них. После перемещения указывайте только нового поставщика. Оставьте «anthropic» на компьютерах, где пользователи остаются подписанными на claude.ai в Claude Desktop, потому что их сеансы Cowork отклоняются без него. Для шлюза, доступного через ANTHROPIC_BASE_URL, укажите "customEndpoint" и поместите URL шлюза в блок env того же управляемого источника.

  • Удалите старые параметры входа: С учетными данными шлюза удалите forceLoginMethod и forceLoginOrgUUID, потому что любой из этих ключей блокирует учетные данные шлюза при запуске. У поставщика облачных услуг эти ключи блокируют сеанс только пока на компьютере остаются определенные учетные данные: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, учетные данные apiKeyHelper или ключ API, сохраненный более ранним входом в Claude Console.

Разработчики могут запустить /status, чтобы увидеть активного поставщика и источник их параметров. Для телеметрии, сетевых хостов и обновлений см. Использование данных, Конфигурация корпоративной сети и Расширенная настройка.

Отслеживайте затраты и использование

На Bedrock, Google Cloud и Foundry использование выставляется по токенам на ваш облачный счет, а элементы управления затратами находятся в консоли выставления счетов облака. Через шлюз использование выставляется по токенам тому, кто владеет учетными данными, которые шлюз пересылает. Панели аналитики claude.ai и API аналитики Claude Code не охватывают это использование. Для отчетности по пользователям используйте OpenTelemetry или шлюз LLM.

Что переходит для разработчиков

Элемент

После перемещения

Что делать

Параметры, CLAUDE.md, автоматическая память, навыки, подагенты, команды, хуки, плагины и серверы MCP

Они остаются. Они находятся в ~/.claude, ~/.claude.json и папке проекта.

Ничего, если вы не выходите (см. ниже). Оставьте эти папки на месте при любой очистке.

Локальные стенограммы сеансов

Они остаются в ~/.claude/projects/ до тех пор, пока cleanupPeriodDays их не удалит. По умолчанию это 30 дней. claude --continue и claude --resume их переоткрывают.

Протестируйте возобновление сеанса в вашем пилоте. На Bedrock, Google Cloud и Foundry более ранняя модель сеанса не восстанавливается. Если вышестоящий сервер шлюза отклоняет более раннюю сигнатуру мышления, Claude Code удаляет более ранние блоки мышления и повторяет попытку.

Облачные сеансы

Anthropic хранит их под учетной записью Claude. --cloud недоступен, когда Claude Code настроен для поставщика третьей стороны, и --resume не отображает облачные сеансы.

Перед перемещением вытащите каждый нужный вам сеанс в терминал с помощью --teleport. Это создает локальную копию. Требуется вход в claude.ai, чистое рабочее дерево, проверка того же репозитория и ветка сеанса, отправленная на удаленный сервер.

Соединители из claude.ai

Не загружаются, когда активен поставщик третьей стороны.

Добавьте их как серверы MCP в области пользователя или проекта, или разверните их через управляемую конфигурацию MCP. Некоторые размещенные Anthropic соединители, такие как Microsoft 365, Gmail и Google Calendar, не поддерживают вход с сервера, который вы добавляете сами, поэтому спланируйте другой сервер для них.

Навыки, синхронизированные из claude.ai

Синхронизация навыков не выполняется в сеансах на Bedrock, Google Cloud или Foundry, или когда учетные данные шлюза заменяют вход claude.ai. Навыки, синхронизированные ранее, остаются на диске в ~/.claude/skills/synced/.

Скопируйте любой навык, на который вы полагаетесь, из ~/.claude/skills/synced/ в ~/.claude/skills/.

Плагины, синхронизированные из claude.ai

Ни загружаются, ни загружаются в сеансах на Bedrock, Google Cloud или Foundry, потому что эти сеансы не получают флаги функций от Anthropic. То же самое верно, когда ANTHROPIC_AUTH_TOKEN или apiKeyHelper предоставляют учетные данные.

Переустановите их с маркетплейса, если он их содержит.

Функции, требующие входа в claude.ai

Недоступны от поставщика. К ним относятся облачные сеансы, Routines, управляемый Code Review, Ultrareview, Remote Control, расширение Chrome и голосовой ввод. Каналы и панель аналитики также недоступны на Bedrock, Google Cloud и Foundry. Также недоступны Advisor и Code Mode. Веб-поиск CLI недоступен на Bedrock. Быстрый режим недоступен на Bedrock и Foundry, а на Google Cloud ограничен Claude Fable 5.2.

Используйте /loop для планирования, GitHub Actions или GitLab CI/CD для облачных запусков (только GitHub Actions на Foundry) и локальный /code-review. Решите, нужны ли разработчикам по-прежнему места Team или Enterprise.

На что обратить внимание во время периода перекрытия

Контрольный список для разработчиков

Перед перемещением

  • Обновите Claude Code до версии, указанной вашими администраторами.

  • Вытащите любые облачные сеансы, которые вам нужны, в терминал с помощью claude --teleport. Сначала убедитесь, что ветка сеанса отправлена на удаленный сервер, и очистите рабочее дерево.

  • Составьте список соединителей claude.ai, которые вы используете, чтобы их можно было добавить как серверы MCP.

  • Скопируйте любой навык, на который вы полагаетесь, из ~/.claude/skills/synced/, и составьте список синхронизированных плагинов, которые вам потребуется переустановить.

В день перемещения

  1. Войдите в поставщика облака так, как описывают ваши администраторы, например с помощью aws sso login, gcloud auth application-default login или az login.

  2. Запустите claude и выполните /status. Проверьте поставщика, модель и источник параметров.

  3. Переоткройте недавний сеанс с помощью claude --resume и подтвердите, что он отвечает.

  4. Сообщите своим администраторам о любом отсутствующем инструменте или соединителе.

Нашли ответ на свой вопрос?