Visión general de las herramientas CLI
Una CLI es una herramienta de línea de comandos, no un software específico. Claude Code, Codex CLI, Gemini CLI, OpenClaw y OpenCode pertenecen a esta categoría: introduces lenguaje natural en la terminal y pueden leer proyectos, interpretar código, generar archivos, ejecutar comandos o ayudarte a completar tareas de desarrollo.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Claude Code Instrucciones oficiales y accesos de instalación Codex CLI Documentación oficial de la CLI de OpenAI Gemini CLI Documentación oficial de la CLI de Google OpenClaw Asistentes de programación para terminal e interfaz web OpenCode Asistentes de programación con IA de código abierto para terminal
¿Qué es una CLI y para qué se utiliza?
Las herramientas CLI son más potentes que el software de chat convencional y también es más fácil cometer errores al usarlas. Cuando los principiantes las configuren por primera vez, ejecútelas únicamente en proyectos de prueba e indíqueles "solo interpretar, no modificar y no ejecutar comandos".
¿Qué preparar primero?
| Elementos de preparación | Descripción | Por qué es importante |
|---|---|---|
| Terminal | Windows utiliza PowerShell, macOS / Linux utiliza Terminal | La CLI se ejecuta por completo en la terminal |
| La propia herramienta | Instala primero Claude Code, Codex CLI, Gemini CLI, OpenClaw u OpenCode | El archivo de configuración solo surte efecto para las herramientas instaladas |
| Clave / Método de inicio de sesión | Puede ser un inicio de sesión oficial, API Key, OAuth o una clave de proveedor de IA | Los métodos de autenticación varían según la CLI |
| Base URL | Solo se necesita al usar un proveedor de IA o un proxy | El sufijo de la dirección puede variar con diferentes protocolos, por lo que no basta con cambiar solo el nombre de dominio. |
| Proyecto de prueba | Crea una nueva carpeta vacía o copia el proyecto. | Evita dañar o alterar un proyecto real durante la primera configuración |
Las URL en la documentación del proveedor de IA suelen ser sus propios ejemplos. Al configurarlas, debes reemplazarlas con la dirección de API y la clave proporcionadas por tu propio proveedor; si ofrece interfaces de OpenAI, Claude y Gemini por separado, no mezcles las tres direcciones.
Accesos a páginas independientes
Configuración de Claude Code Clave, Base URL, modelo y settings.json de Claude Code.
Configuración de Codex CLI config.toml, proveedores personalizados y métodos de prueba para la herramienta de terminal Codex.
Configuración de Gemini CLI Notas sobre el inicio de sesión de Google, API Key y proveedores de IA para Gemini CLI.
Configuración de OpenClaw Los campos baseUrl y api de OpenClaw se configuran en parejas.
Configuración de OpenCode Asistente de conexión de OpenCode, ubicación del archivo de configuración y consideraciones de configuración manual.
¿Cómo elegir qué página consultar?
| ¿Qué deseas hacer ahora? | Página recomendada | Motivo |
|---|---|---|
| Solo deseo cambiar de forma unificada entre múltiples proveedores de CLI | Pasos generales de CC-Switch | CC-Switch es más adecuado para la gestión centralizada de proveedores y su posterior distribución a herramientas como Claude, Codex, Gemini, etc. |
| Solo configurar Claude Code | Configuración de Claude Code | Para Claude Code, enfócate en la clave relacionada con Anthropic / Claude, la Base URL, el nombre del modelo y settings.json |
| Solo configurar Codex CLI | Configuración de Codex | Para Codex, enfócate en config.toml, proveedores compatibles con OpenAI, el nombre del modelo y las variables de entorno |
| Solo configurar Gemini CLI | Configuración de Gemini | El método de inicio de sesión, la clave y las interfaces Vertex / Gemini de Gemini son diferentes de las interfaces compatibles con OpenAI |
| Usar OpenClaw / OpenCode | OpenClaw / OpenCode | El campo de proveedor para estas dos herramientas puede cambiar según la versión; consulta la página correspondiente y la documentación oficial |
Riesgos a tener en cuenta antes de la configuración
| Riesgos | Dónde suelen ocurrir | Recomendaciones |
|---|---|---|
| Las herramientas pueden leer archivos del proyecto | Claude Code, Codex, Gemini, OpenClaw, OpenCode | Ejecútalas en un directorio de prueba la primera vez; no abras directamente proyectos reales de producción |
| Los modelos pueden ejecutar o sugerir comandos | Todas las CLI de programación | Activa primero el modo de confirmación y revisa cada acción con atención al encontrar comandos de eliminación, traslado, instalación, subida, etc. |
| Los elementos de configuración se anulan entre sí | Variables de entorno del sistema, configuración del proyecto, configuración del usuario, CC-Switch | Cuando la configuración no surta efecto, verifica primero la prioridad; no modifiques varios lugares al mismo tiempo |
| Uso mixto de protocolos | Interfaces compatibles de OpenAI, Claude, Gemini, Vertex y proveedores de IA | Completa los campos en la herramienta según la interfaz específica que proporcione el panel del proveedor |
| Copiar el ejemplo de otra persona | Tutoriales de terceros, capturas de pantalla, documentación antigua | La URL, la clave y el nombre del modelo del ejemplo deben reemplazarse con los datos del panel de tu propio proveedor |
¿Cómo realizar la primera prueba de seguridad?
Una vez completada la configuración, no permitas de inmediato que la CLI modifique un proyecto real. Primero, crea un directorio vacío, coloca un archivo de prueba simple dentro y permite que la herramienta solo lea e interprete, sin modificar ningún archivo.
Comando de prueba de seguridad para enviar a la CLI
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.Si este paso no responde con normalidad, ve a la página correspondiente de solución de problemas. No permitas que la CLI procese automáticamente el proyecto real antes de confirmar que la configuración es correcta.