Si tus desarrolladores usan Claude Code CLI, configúralo por separado de la aplicación de escritorio. La aplicación de escritorio obtiene su configuración de proveedor de Claude Desktop en configuración de terceros, no de ANTHROPIC_BASE_URL o settings.json, y la pasa a las sesiones de Code que inicia. La CLI lee variables de entorno, archivos de configuración y configuración administrada de Claude Code, que usan una clave de política separada.
Esta guía es para administradores de organizaciones en planes Claude Enterprise.
Este artículo es parte de Migrar de Claude Enterprise a Claude Desktop en un proveedor en la nube, que define los términos onda, período de superposición y fecha de corte.
La CLI y todo lo que se ejecuta localmente funciona en todos los proveedores. Después de la migración, los desarrolladores inician sesión de forma diferente, tus políticas llegan a sus computadoras de forma diferente y algunas funciones no están disponibles.
Conectar la CLI a tu proveedor
Establece las variables del proveedor para Amazon Bedrock, Google Cloud, Microsoft Foundry, o una puerta de enlace LLM. Los desarrolladores no necesitan un inicio de sesión en el navegador de claude.ai. Con una puerta de enlace, establece tanto la URL base como una credencial de puerta de enlace. Solo con la URL base, un inicio de sesión guardado de claude.ai permanece como la credencial activa, por lo que sus límites y facturación siguen siendo aplicables. Antes de un lanzamiento en equipo, fija tus versiones de modelo.
Entregar política a cada dispositivo
La configuración administrada por servidor no se aplica cuando se establece un proveedor de terceros o una URL base personalizada. Mueve esas políticas a configuración administrada en el dispositivo. Puedes entregarlas como un archivo managed-settings.json, el perfil macOS com.anthropic.claudecode, o la clave de registro HKLM\SOFTWARE\Policies\ClaudeCode. Tienen prioridad sobre la configuración de usuario y proyecto, excepto por algunas claves sensibles de seguridad donde un valor más estricto de un nivel inferior aún cuenta.
Limita qué proveedores puede usar una computadora: Establece
allowedProviders(Claude Code v2.1.285 o posterior). Durante el período de superposición, una lista como["anthropic", "bedrock"]permite que los desarrolladores usen cualquiera de los dos. Después de la migración, lista solo el nuevo proveedor. Mantén «anthropic» en computadoras donde los usuarios permanecen conectados a claude.ai en Claude Desktop, porque sus sesiones de Cowork se rechazan sin él. Para una puerta de enlace alcanzada a través deANTHROPIC_BASE_URL, lista"customEndpoint"y coloca la URL de la puerta de enlace en el bloqueenvde la misma fuente administrada.Elimina la configuración de inicio de sesión anterior: Con credenciales de puerta de enlace, elimina
forceLoginMethodyforceLoginOrgUUID, porque cualquiera de estas claves bloquea las credenciales de puerta de enlace al inicio. En un proveedor en la nube, esas claves bloquean una sesión solo mientras ciertas credenciales aún estén en la computadora:ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN, una credencialapiKeyHelper, o una clave de API guardada por un inicio de sesión anterior de Claude Console.
Los desarrolladores pueden ejecutar /status para ver el proveedor activo y de dónde proviene su configuración. Para telemetría, hosts de red y actualizaciones, consulta Uso de datos, Configuración de red empresarial, y Configuración avanzada.
Rastrear costo y uso
En Bedrock, Google Cloud y Foundry, el uso se factura por token a tu cuenta en la nube, y los controles de costo están en tu consola de facturación en la nube. A través de una puerta de enlace, el uso se factura por token a quien sea propietario de la credencial que la puerta de enlace reenvía. Los paneles de análisis de claude.ai y la API de Analytics de Claude Code no cubren este uso. Para informes por usuario, usa OpenTelemetry o una puerta de enlace LLM.
Lo que se mantiene para los desarrolladores
Elemento | Después de la migración | Qué hacer |
Configuración, | Se mantienen. Viven en | Nada, a menos que cierres sesión (ver abajo). Deja estas carpetas en su lugar durante cualquier limpieza. |
Transcripciones de sesión local | Se mantienen en | Prueba reanudar una sesión en tu piloto. En Bedrock, Google Cloud y Foundry, el modelo anterior de la sesión no se restaura. Si el upstream de una puerta de enlace rechaza una firma de pensamiento anterior, Claude Code descarta los bloques de pensamiento anterior e intenta de nuevo. |
Sesiones en la nube | Anthropic las almacena bajo la cuenta de Claude. | Antes de la migración, extrae cada sesión que necesites en la terminal con |
Conectores desde claude.ai | No se cargan cuando un proveedor de terceros está activo. | Agréguelos como servidores MCP en alcance de usuario o proyecto, o despliéguelos a través de configuración MCP administrada. Algunos conectores alojados por Anthropic, como Microsoft 365, Gmail y Google Calendar, no admiten inicio de sesión desde un servidor que agregues tú mismo, así que planifica un servidor diferente para esos. |
Habilidades sincronizadas desde claude.ai | La sincronización de habilidades no se ejecuta en sesiones en Bedrock, Google Cloud o Foundry, o cuando una credencial de puerta de enlace reemplaza el inicio de sesión de claude.ai. Las habilidades sincronizadas anteriormente permanecen en el disco en | Copia cualquier habilidad en la que confíes desde |
Complementos sincronizados desde claude.ai | Ni descargados ni cargados en sesiones en Bedrock, Google Cloud o Foundry, porque esas sesiones no obtienen indicadores de características de Anthropic. Lo mismo ocurre cuando | Reinstálalos desde un mercado, si uno los tiene. |
Funciones que necesitan un inicio de sesión en claude.ai | No accesibles desde un proveedor. Estos incluyen sesiones en la nube, Rutinas, Revisión de código administrada, Ultrareview, Control remoto, la extensión de Chrome y dictado de voz. Los canales y el panel de análisis tampoco están disponibles en Bedrock, Google Cloud y Foundry. Tampoco lo están el Asesor y el Modo de código. La búsqueda web de la CLI no está disponible en Bedrock. El modo rápido no está disponible en Bedrock y Foundry, y en Google Cloud se limita a Claude Fable 5.2. | Usa |
Qué vigilar durante el período de superposición
La configuración administrada por servidor tiene prioridad en sesiones que aún se autentican con claude.ai. Por defecto, Claude Code las usa y omite la configuración administrada en el dispositivo, con algunas excepciones como el bloque
envyallowedProviders. Si algunos desarrolladores permanecen en claude.ai, usa configuración administrada por servidor para ellos y un archivo o política del SO para todos los demás.Un inicio de sesión guardado de claude.ai permanece en la computadora. Las credenciales del proveedor en la nube tienen precedencia sobre él, y
/logoutno está disponible una vez que un proveedor en la nube está activo. Si deseas que se elimine el inicio de sesión, pide a los desarrolladores que cierren sesión antes de implementar la configuración del proveedor. Cerrar sesión también elimina los inicios de sesión guardados del servidor MCP y los secretos de complementos, por lo que tendrán que autorizarlos de nuevo. Con una credencial de puerta de enlace,/logoutpermanece disponible, y puedes ejecutarlo para borrar el inicio de sesión guardado.La política de CLI puede anular parte de tu política de escritorio. Por defecto, si una computadora tiene configuración administrada de Claude Code, una sesión de Code de escritorio ignora los valores de política administrada que proporciona la aplicación de escritorio. Para usar ambos, consulta
parentSettingsBehavioren Implementar configuración administrada.
Lista de verificación para desarrolladores
Antes de la migración
Actualiza Claude Code a la versión que especifiquen tus administradores.
Extrae cualquier sesión en la nube que necesites en la terminal con
claude --teleport. Primero asegúrate de que la rama de la sesión esté enviada al remoto y limpia tu árbol de trabajo.Lista los conectores de claude.ai que uses, para que puedan agregarse como servidores MCP.
Copia cualquier habilidad en la que confíes fuera de
~/.claude/skills/synced/, y lista los complementos sincronizados que necesitarás reinstalar.
El día que migres
Inicia sesión en tu proveedor en la nube de la forma que describan tus administradores, por ejemplo con
aws sso login,gcloud auth application-default login, oaz login.Inicia
claudey ejecuta/status. Verifica el proveedor, el modelo y la fuente de configuración.Reabre una sesión reciente con
claude --resumey confirma que responde.Informa a tus administradores sobre cualquier herramienta o conector que falte.
