> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Referencia de CLI
> Referencia completa de la interfaz de línea de comandos de Fuxi Code, incluyendo comandos y banderas.
Comandos CLI
Puede iniciar sesiones, canalizar contenido, reanudar conversaciones y administrar actualizaciones con estos comandos:
| Comando | Descripción | Ejemplo |
| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| `fuxi` | Iniciar sesión interactiva | `fuxi` |
| `fuxi "query"` | Iniciar sesión interactiva con indicación inicial | `fuxi "explain this project"` |
| `fuxi -p "query"` | Consultar a través de SDK, luego salir | `fuxi -p "explain this function"` |
| `cat file \| fuxi -p "query"` | Procesar contenido canalizado | `cat logs.txt \| fuxi -p "explain"` |
| `fuxi -c` | Continuar la conversación más reciente en el directorio actual | `fuxi -c` |
| `fuxi -c -p "query"` | Continuar a través de SDK | `fuxi -c -p "Check for type errors"` |
| `fuxi -r "" "query"` | Reanudar sesión por ID o nombre | `fuxi -r "auth-refactor" "Finish this PR"` |
| `fuxi update` | Actualizar a la versión más reciente | `fuxi update` |
| `fuxi gateway` | Iniciar el servidor de [puerta de enlace de aplicaciones Fuxi](/es/fuxi-apps-gateway) autohospedado, para administradores que implementan SSO y política frente a Fuxi Code en Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Requiere `--config` apuntando a un [`gateway.yaml`](/es/fuxi-apps-gateway-config). Disponible en Fuxi Code v2.1.195 y posterior. | `fuxi gateway --config gateway.yaml` |
| `fuxi install [version]` | Instalar o reinstalar el binario nativo. Acepta una versión como `2.1.118`, o `stable` o `latest`. Consulte [Instalar una versión específica](/es/setup#install-a-specific-version) | `fuxi install stable` |
| `fuxi auth login` | Inicie sesión en su cuenta de Anthropic. Use `--email` para rellenar previamente su dirección de correo electrónico, `--sso` para forzar la autenticación SSO y `--console` para iniciar sesión con Anthropic Console para facturación de uso de API en lugar de una suscripción a Fuxi | `fuxi auth login --console` |
| `fuxi auth logout` | Cerrar sesión en su cuenta de Anthropic | `fuxi auth logout` |
| `fuxi auth status` | Mostrar estado de autenticación como JSON. Use `--text` para salida legible por humanos. Sale con código 0 si ha iniciado sesión, 1 si no | `fuxi auth status` |
| `fuxi agents` | Abrir [vista de agentes](/es/agent-view) para monitorear y enviar sesiones de fondo paralelas. Use `--cwd ` para mostrar solo sesiones iniciadas en ese directorio, o `--json` para imprimir sesiones activas como una matriz JSON para scripts (`--json --all` también incluye sesiones de fondo completadas). Pase `--permission-mode`, `--model`, `--effort` o `--agent` para establecer [valores predeterminados para sesiones enviadas](/es/agent-view#permission-mode-model-and-effort). Acepta `--settings`, `--add-dir`, `--plugin-dir` y `--mcp-config` como el comando `fuxi` de nivel superior. Abrir la vista de agentes requiere una terminal interactiva | `fuxi agents --json` |
| `fuxi attach ` | Adjuntar a una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell) en esta terminal | `fuxi attach 7c5dcf5d` |
| `fuxi auto-mode defaults` | Imprimir las reglas del clasificador de [auto mode](/es/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `fuxi auto-mode config` para ver su configuración efectiva con la configuración aplicada | `fuxi auto-mode defaults > rules.json` |
| `fuxi daemon status` | Imprimir el estado del [supervisor](/es/agent-view#the-supervisor-process) de sesión de fondo, versión, directorio de socket y recuento de trabajadores para diagnósticos. Sale con 1 si el supervisor no se está ejecutando | `fuxi daemon status` |
| `fuxi daemon stop --any` | Detener el [supervisor](/es/agent-view#the-supervisor-process) de sesión de fondo y las sesiones que aloja. Pase `--keep-workers` para dejar las sesiones de fondo en ejecución para que el próximo supervisor se reconecte a ellas. `--any` confirma la detención de un supervisor bajo demanda, que es el predeterminado. Use esto para recuperarse de un [supervisor que no responde](/es/agent-view#agent-view-says-the-background-service-did-not-respond) | `fuxi daemon stop --any --keep-workers` |
| `fuxi doctor` | Imprimir diagnósticos de instalación y configuración de solo lectura desde la terminal sin iniciar una sesión, incluida la salud de la instalación, errores de validación de archivos de configuración e idoneidad de Remote Control. Para la verificación de configuración en sesión que también puede aplicar correcciones, ejecute [`/doctor`](/es/commands#all-commands) | `fuxi doctor` |
| `fuxi logs ` | Imprimir salida reciente de una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell) | `fuxi logs 7c5dcf5d` |
| `fuxi mcp` | Configurar servidores Model Context Protocol (MCP) | Consulte la [documentación de Fuxi Code MCP](/es/mcp). |
| `fuxi mcp login ` | {/* min-version: 2.1.186 */}Ejecutar el flujo OAuth de un servidor MCP configurado sin abrir el panel interactivo `/mcp`. Funciona para servidores HTTP, SSE y conectores de fuxi.ai. Agregue `--no-browser` sobre SSH para imprimir la URL de autorización en lugar de abrir un navegador, luego pegue la URL de redirección nuevamente en el indicador. Requiere Fuxi Code v2.1.186 o posterior. Consulte [Autenticar desde la línea de comandos](/es/mcp#authenticate-from-the-command-line) | `fuxi mcp login sentry` |
| `fuxi mcp logout ` | {/* min-version: 2.1.186 */}Borrar credenciales OAuth almacenadas para un servidor MCP. Requiere Fuxi Code v2.1.186 o posterior | `fuxi mcp logout sentry` |
| `fuxi plugin` | Administrar Fuxi Code [plugins](/es/plugins). Alias: `fuxi plugins`. Consulte [referencia de plugins](/es/plugins-reference#cli-commands-reference) para subcomandos | `fuxi plugin install code-review@fuxi-plugins-official` |
| `fuxi project purge [path]` | Eliminar todo el estado local de Fuxi Code para un proyecto: transcripciones, listas de tareas, registros de depuración, historial de edición de archivos, líneas de historial de indicaciones y la entrada del proyecto en `~/.fuxi.json`. Omita `[path]` para elegir de una lista interactiva. Banderas: `--dry-run` para vista previa, `-y`/`--yes` para omitir confirmación, `-i`/`--interactive` para confirmar cada elemento, `--all` para cada proyecto. Consulte [Borrar datos locales](/es/fuxi-directory#clear-local-data) | `fuxi project purge ~/work/repo --dry-run` |
| `fuxi remote-control` | Iniciar un servidor de [Remote Control](/es/remote-control) para controlar Fuxi Code desde Fuxi.ai o la aplicación Fuxi. Se ejecuta en modo servidor (sin sesión interactiva local). Consulte [Banderas de modo servidor](/es/remote-control#start-a-remote-control-session) | `fuxi remote-control --name "My Project"` |
| `fuxi respawn ` | Reiniciar una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell), en ejecución o detenida, con su conversación intacta. Use `--all` para reiniciar cada sesión en ejecución, por ejemplo, para recoger un binario de Fuxi Code actualizado | `fuxi respawn 7c5dcf5d` |
| `fuxi rm ` | Eliminar una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell) de la lista. La transcripción de la conversación permanece en su máquina local, disponible a través de `fuxi --resume` | `fuxi rm 7c5dcf5d` |
| `fuxi setup-token` | Generar un token OAuth de larga duración para CI y scripts. Imprime el token en la terminal sin guardarlo. Requiere una suscripción a Fuxi. Consulte [Generar un token de larga duración](/es/authentication#generate-a-long-lived-token) | `fuxi setup-token` |
| `fuxi stop ` | Detener una [sesión de fondo](/es/agent-view#manage-sessions-from-the-shell). También acepta `fuxi kill` | `fuxi stop 7c5dcf5d` |
| `fuxi ultrareview [target]` | Ejecutar [ultrareview](/es/ultrareview#run-ultrareview-non-interactively) de forma no interactiva. Imprime los hallazgos en stdout y sale con 0 en caso de éxito o 1 en caso de fallo. Use `--json` para la carga útil sin procesar y `--timeout ` para anular el valor predeterminado de 30 minutos | `fuxi ultrareview 1234 --json` |
Si escribe mal un subcomando, Fuxi Code sugiere la coincidencia más cercana y sale sin iniciar una sesión. Por ejemplo, `fuxi udpate` imprime `Did you mean fuxi update?`.
{/* min-version: 2.1.199 */}A partir de v2.1.199, `fuxi --dangerously-skip-permissions daemon ` ejecuta el subcomando `daemon`. Las versiones anteriores trataban `daemon ` como el indicador para una nueva sesión interactiva, por lo que el subcomando nunca se ejecutaba cuando la bandera venía primero, una configuración común cuando `fuxi` tiene un alias que incluye la bandera. Solo un `--dangerously-skip-permissions` o `--allow-dangerously-skip-permissions` inicial enruta a `daemon` de esta manera; cualquier otra bandera inicial aún inicia una sesión interactiva.
Banderas CLI
Personalice el comportamiento de Fuxi Code con estas banderas de línea de comandos. `fuxi --help` no enumera todas las banderas, por lo que la ausencia de una bandera en `--help` no significa que no esté disponible.
| Bandera | Descripción | Ejemplo |
| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
| `--add-dir` | Agregar directorios de trabajo adicionales para que Fuxi lea y edite archivos. Otorga acceso a archivos; la mayoría de la configuración de `.fuxi/` [no se descubre](/es/permissions#additional-directories-grant-file-access-not-configuration) desde estos directorios. Valida que cada ruta exista como directorio. Para persistir estos directorios entre sesiones, establezca [`permissions.additionalDirectories`](/es/settings#permission-settings) en configuración | `fuxi --add-dir ../apps ../lib` |
| `--advisor ` | Habilitar la [herramienta advisor](/es/advisor) del lado del servidor para esta sesión con un alias de modelo: `opus`, `sonnet` o `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID de modelo completo. Tiene prioridad sobre la configuración `advisorModel` para la sesión | `fuxi --advisor opus` |
| `--agent` | Especificar un agente para la sesión actual (anula la configuración `agent`) | `fuxi --agent my-custom-agent` |
| `--agents` | Definir subagents personalizados dinámicamente a través de JSON. Utiliza los mismos nombres de campo que el [frontmatter](/es/sub-agents#supported-frontmatter-fields) de subagent, más un campo `prompt` para las instrucciones del agente | `fuxi --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
| `--allow-dangerously-skip-permissions` | Agregar `bypassPermissions` al ciclo de modo `Shift+Tab` sin comenzar en él. Permite comenzar en un modo diferente como `plan` y cambiar a `bypassPermissions` más tarde. Consulte [modos de permiso](/es/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `fuxi --permission-mode plan --allow-dangerously-skip-permissions` |
| `--allowedTools`, `--allowed-tools` | Herramientas que se ejecutan sin solicitar permiso. Consulte [sintaxis de regla de permiso](/es/settings#permission-rule-syntax) para coincidencia de patrones. Para restringir qué herramientas están disponibles, use `--tools` en su lugar | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Agregar texto personalizado al final del indicador del sistema de cada [subagent](/es/sub-agents), incluidos subagents anidados. Solo se aplica en modo no interactivo con `-p`. Requiere Fuxi Code v2.1.205 o posterior | `fuxi -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |
| `--append-system-prompt` | Agregar texto personalizado al final del indicador del sistema predeterminado | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Cargar texto de indicación del sistema adicional desde un archivo y agregar al indicador predeterminado | `fuxi --append-system-prompt-file ./extra-rules.txt` |
| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizar salida compatible con lector de pantalla: texto plano sin bordes decorativos ni animaciones. Fuerza el renderizador clásico, por lo que la configuración [`tui`](/es/settings#available-settings) no tiene efecto; las [sesiones de fondo](/es/agent-view) adjuntas aún se renderizan a pantalla completa. Tiene prioridad sobre [`FUXI_AX_SCREEN_READER`](/es/env-vars) y la configuración [`axScreenReader`](/es/settings#available-settings). Requiere Fuxi Code v2.1.181 o posterior | `fuxi --ax-screen-reader` |
| `--bare` | Modo mínimo: omitir el descubrimiento automático de hooks, skills, plugins, servidores MCP, memoria automática y FUXI.md para que las llamadas con script se inicien más rápido. Fuxi tiene acceso a herramientas Bash, lectura de archivos y edición de archivos. Establece [`FUXI_CODE_SIMPLE`](/es/env-vars). Consulte [bare mode](/es/headless#start-faster-with-bare-mode) | `fuxi --bare -p "query"` |
| `--betas` | Encabezados beta para incluir en solicitudes de API (solo usuarios con clave API) | `fuxi --betas interleaved-thinking` |
| `--bg`, `--background` | Iniciar la sesión como un [agente de fondo](/es/agent-view) y regresar inmediatamente. Imprime el ID de sesión y comandos de administración. Combine con `--exec` para ejecutar un comando de shell como un trabajo de fondo en lugar de una sesión de Fuxi, o con `--agent` para ejecutar un subagent específico. {/* min-version: 2.1.198 */}No se puede combinar con `-p`/`--print`; consulte la [referencia de errores](/es/errors#command-line-errors) | `fuxi --bg "investigate the flaky test"` |
| `--channels` | (Vista previa de investigación) Servidores MCP cuyas notificaciones de [channel](/es/channels) Fuxi debe escuchar en esta sesión. Lista separada por espacios de entradas `plugin:@`. Requiere autenticación de Fuxi.ai | `fuxi --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | Habilitar [integración del navegador Chrome](/es/chrome) para automatización web y pruebas | `fuxi --chrome` |
| `--cloud` | Crear una nueva [sesión web](/es/fuxi-code-on-the-web) en fuxi.ai con la descripción de tarea proporcionada | `fuxi --cloud "Fix the login bug"` |
| `--continue`, `-c` | Cargar la conversación más reciente en el directorio actual. Incluye sesiones que agregaron este directorio con `/add-dir` | `fuxi --continue` |
| `--dangerously-load-development-channels` | Habilitar [channels](/es/channels-reference#test-during-the-research-preview) que no están en la lista de permitidos aprobada, para desarrollo local. Acepta entradas `plugin:@` y `server:`. Solicita confirmación | `fuxi --dangerously-load-development-channels server:webhook` |
| `--dangerously-skip-permissions` | Omitir indicadores de permiso. Equivalente a `--permission-mode bypassPermissions`. Consulte [modos de permiso](/es/permission-modes#skip-all-checks-with-bypasspermissions-mode) para ver qué hace y no hace esto | `fuxi --dangerously-skip-permissions` |
| `--debug` | Habilitar modo de depuración con filtrado de categoría opcional (por ejemplo, `"api,hooks"` o `"!statsig,!file"`) | `fuxi --debug "api,mcp"` |
| `--debug-file ` | Escribir registros de depuración en una ruta de archivo específica. Habilita implícitamente el modo de depuración. Tiene prioridad sobre `FUXI_CODE_DEBUG_LOGS_DIR` | `fuxi --debug-file /tmp/fuxi-debug.log` |
| `--disable-slash-commands` | Deshabilitar todas las skills y comandos para esta sesión | `fuxi --disable-slash-commands` |
| `--disallowedTools`, `--disallowed-tools` | Reglas de denegación. Un nombre de herramienta simple elimina esa herramienta del contexto del modelo: `"Edit"` elimina Edit, `"*"` elimina todas las herramientas, y `"mcp__*"` elimina todas las herramientas MCP. Una regla con alcance como `Bash(rm *)` deja la herramienta disponible y deniega solo las llamadas coincidentes | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
| `--effort` | Establecer el [nivel de esfuerzo](/es/model-config#adjust-effort-level) para la sesión actual. Opciones: `low`, `medium`, `high`, `xhigh`, `max`, o {/* min-version: 2.1.203 */}`ultracode`. Los niveles disponibles dependen del modelo. `ultracode` inicia la sesión en esfuerzo `xhigh` con [ultracode](/es/workflows#let-fuxi-decide-with-ultracode) activado, y requiere Fuxi Code v2.1.203 o posterior. Anula la configuración [`effortLevel`](/es/settings#available-settings) para esta sesión y no persiste | `fuxi --effort high` |
| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Eliminado en v2.1.111. Auto mode ahora está en el ciclo `Shift+Tab` de forma predeterminada; use `--permission-mode auto` para comenzar en él | `fuxi --permission-mode auto` |
| `--exclude-dynamic-system-prompt-sections` | Mover secciones por máquina del indicador del sistema (directorio de trabajo, información del entorno, rutas de memoria, estado de git) al primer mensaje del usuario. Mejora la reutilización de caché de indicación en diferentes usuarios y máquinas que ejecutan la misma tarea. Solo se aplica con el indicador del sistema predeterminado; se ignora cuando se establece `--system-prompt` o `--system-prompt-file`. Use con `-p` para cargas de trabajo con script y múltiples usuarios | `fuxi -p --exclude-dynamic-system-prompt-sections "query"` |
| `--exec` | Ejecutar un comando de shell como un trabajo de fondo respaldado por PTY en lugar de iniciar una sesión de Fuxi. Use con `--bg` para lanzar desde el shell | `fuxi --bg --exec 'pytest -x'` |
| `--fallback-model` | Habilitar fallback automático a los modelos especificados cuando el modelo principal está sobrecargado o no está disponible, por ejemplo un modelo retirado. Acepta una lista separada por comas probada en orden. Consulte [Cadenas de modelo de fallback](/es/model-config#fallback-model-chains). Para persistir una cadena entre sesiones, use la configuración [`fallbackModel`](/es/settings#available-settings), que esta bandera anula | `fuxi --fallback-model sonnet,haiku` |
| `--fork-session` | Al reanudar, crear un nuevo ID de sesión en lugar de reutilizar el original (usar con `--resume` o `--continue`) | `fuxi --resume abc123 --fork-session` |
| `--from-pr` | Reanudar sesiones vinculadas a una solicitud de extracción específica. Acepta un número de PR, una URL de PR de GitHub o GitHub Enterprise, una URL de solicitud de fusión de GitLab o una URL de solicitud de extracción de Bitbucket. Las sesiones se vinculan automáticamente cuando Fuxi crea la solicitud de extracción | `fuxi --from-pr 123` |
| `--ide` | Conectarse automáticamente al IDE al iniciar si exactamente un IDE válido está disponible | `fuxi --ide` |
| `--init` | Ejecutar [Setup hooks](/es/hooks#setup) con el matcher `init` antes de la sesión (solo modo impresión) | `fuxi -p --init "query"` |
| `--init-only` | Ejecutar hooks de [Setup](/es/hooks#setup) y `SessionStart`, luego salir sin iniciar una conversación | `fuxi --init-only` |
| `--include-hook-events` | Incluir todos los eventos del ciclo de vida del hook en el flujo de salida. Requiere `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-hook-events "query"` |
| `--include-partial-messages` | Incluir eventos de transmisión parcial en la salida. Requiere `--print` y `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-partial-messages "query"` |
| `--input-format` | Especificar formato de entrada para modo impresión (opciones: `text`, `stream-json`) | `fuxi -p --output-format json --input-format stream-json` |
| `--json-schema` | Obtener salida JSON validada que coincida con un JSON Schema después de que el agente complete su flujo de trabajo (solo modo impresión). Consulte [salidas estructuradas](/es/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Fuxi Code sale con un error en un esquema inválido y acepta la palabra clave `format` como anotación sin validación del lado del cliente. Antes de v2.1.205, un esquema inválido producía salida no estructurada sin error, y esquemas que usaban `format` se trataban como inválidos | `fuxi -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | Ejecutar [Setup hooks](/es/hooks#setup) con el matcher `maintenance` antes de la sesión (solo modo impresión) | `fuxi -p --maintenance "query"` |
| `--max-budget-usd` | Cantidad máxima en dólares a gastar en llamadas API antes de detener (solo modo impresión) | `fuxi -p --max-budget-usd 5.00 "query"` |
| `--max-turns` | Limitar el número de turnos de agente (solo modo impresión). Sale con un error cuando se alcanza el límite. Sin límite por defecto. {/* min-version: 2.1.205 */}Con `--input-format stream-json`, un mensaje enviado mientras Fuxi está trabajando permanece en cola y se ejecuta como su propio turno, con su propio límite, cuando el límite termina el actual. Antes de v2.1.205, Fuxi Code descartaba ese mensaje | `fuxi -p --max-turns 3 "query"` |
| `--mcp-config` | Cargar servidores MCP desde archivos JSON o cadenas (separados por espacios) | `fuxi --mcp-config ./mcp.json` |
| `--model` | Establece el modelo para la sesión actual con un alias para el modelo más reciente (`sonnet`, `opus`, `haiku` o `fable`) o el nombre completo de un modelo. Anula la configuración [`model`](/es/settings#available-settings) y [`ANTHROPIC_MODEL`](/es/model-config#environment-variables) | `fuxi --model fuxi-sonnet-5` |
| `--name`, `-n` | Establecer un nombre para mostrar para la sesión, que se muestra en `/resume` y en el título de la terminal. Puede reanudar una sesión nombrada con `fuxi --resume `.
[`/rename`](/es/commands) cambia el nombre durante la sesión y también lo muestra en la barra de indicación | `fuxi -n "my-feature-work"` |
| `--no-chrome` | Deshabilitar [integración del navegador Chrome](/es/chrome) para esta sesión | `fuxi --no-chrome` |
| `--no-session-persistence` | Deshabilitar la persistencia de sesión para que las sesiones no se guarden en disco y no se puedan reanudar. Solo modo impresión. La variable de entorno [`FUXI_CODE_SKIP_PROMPT_HISTORY`](/es/env-vars) hace lo mismo en cualquier modo | `fuxi -p --no-session-persistence "query"` |
| `--output-format` | Especificar formato de salida para modo impresión (opciones: `text`, `json`, `stream-json`) | `fuxi -p "query" --output-format json` |
| `--permission-mode` | Comenzar en un [modo de permiso](/es/permission-modes) especificado. Acepta `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` o {/* min-version: 2.1.200 */}`manual` como alias para `default`. El alias `manual` selecciona el modo que la interfaz de usuario etiqueta como Manual y requiere Fuxi Code v2.1.200 o posterior; `fuxi --help` lo enumera en lugar de `default`, y ambos valores funcionan. Anula `defaultMode` de archivos de configuración | `fuxi --permission-mode plan` |
| `--permission-prompt-tool` | Especificar una herramienta MCP para manejar indicadores de permiso en modo no interactivo. {/* min-version: 2.1.199 */}A partir de v2.1.199, la herramienta de indicación no puede aprobar una herramienta MCP marcada como [requiriendo interacción del usuario](/es/mcp#require-approval-for-a-specific-tool): un resultado `allow` para una se convierte en una denegación | `fuxi -p --permission-prompt-tool mcp_auth_tool "query"` |
| `--plugin-dir` | Cargar un plugin desde un directorio o archivo `.zip` solo para esta sesión. Cada bandera toma una ruta. Repita la bandera para múltiples plugins: `--plugin-dir A --plugin-dir B.zip` | `fuxi --plugin-dir ./my-plugin` |
| `--plugin-url` | Obtener un archivo `.zip` de plugin desde una URL solo para esta sesión. Repita la bandera para múltiples plugins, o pase URLs separadas por espacios en un valor único entre comillas | `fuxi --plugin-url https://example.com/plugin.zip` |
| `--print`, `-p` | Imprimir respuesta sin modo interactivo (consulte [documentación de Agent SDK](/es/agent-sdk/overview) para detalles de uso programático) | `fuxi -p "query"` |
| `--prompt-suggestions` | Emitir un mensaje `prompt_suggestion` después de cada turno con un siguiente indicador de usuario predicho. Requiere `--print`, `--output-format stream-json` y `--verbose`. Consulte [Sugerencias de indicación](/es/interactive-mode#prompt-suggestions) | `fuxi -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | Alias obsoleto para `--cloud` | `fuxi --remote "Fix the login bug"` |
| `--remote-control`, `--rc` | Iniciar una sesión interactiva con [Remote Control](/es/remote-control#start-a-remote-control-session) habilitado para que también pueda controlarlo desde fuxi.ai o la aplicación Fuxi. Opcionalmente pase un nombre para la sesión | `fuxi --remote-control "My Project"` |
| `--remote-control-session-name-prefix ` | Prefijo para nombres de sesión de [Remote Control](/es/remote-control) generados automáticamente cuando no se establece un nombre explícito. Por defecto es el nombre de host de su máquina, produciendo nombres como `myhost-graceful-unicorn`. Establezca `FUXI_REMOTE_CONTROL_SESSION_NAME_PREFIX` para el mismo efecto | `fuxi remote-control --remote-control-session-name-prefix dev-box` |
| `--replay-user-messages` | Re-emitir mensajes de usuario desde stdin de vuelta en stdout para reconocimiento. Requiere `--input-format stream-json` y `--output-format stream-json` | `fuxi -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |
| `--resume`, `-r` | Reanudar una sesión específica por ID o nombre, o mostrar un selector interactivo para elegir una sesión. El selector y la búsqueda de nombre incluyen sesiones que agregaron este directorio con `/add-dir`; pasar un ID de sesión busca solo en el directorio del proyecto actual y sus git worktrees. A partir de v2.1.144, [sesiones de fondo](/es/agent-view) aparecen en el selector marcadas con `bg` | `fuxi --resume auth-refactor` |
| `--safe-mode` | {/* min-version: 2.1.169 */}Comenzar con todas las personalizaciones deshabilitadas para solucionar problemas de una configuración rota: FUXI.md, skills, plugins, hooks, servidores MCP, comandos y agentes personalizados, estilos de salida, flujos de trabajo, temas personalizados, atajos de teclado personalizados, comandos de línea de estado y sugerencia de archivos, servidores LSP y memoria automática no se cargan. La autenticación, selección de modelo, herramientas integradas y permisos funcionan normalmente, lo que difiere de [`--bare`](/es/headless#start-faster-with-bare-mode). La política de configuración administrada aún se aplica, incluidos hooks configurados por política, línea de estado y comandos de sugerencia de archivos; plugins administrados, skills administrados, FUXI.md administrado y servidores MCP configurados por política no. Útil para verificar si una personalización es lo que desencadena [fallback automático de Fable 5](/es/model-config#automatic-model-fallback). Establece [`FUXI_CODE_SAFE_MODE`](/es/env-vars) | `fuxi --safe-mode` |
| `--session-id` | Usar un ID de sesión específico para la conversación (debe ser un UUID válido) | `fuxi --session-id "550e8400-e29b-41d4-a716-446655440000"` |
| `--setting-sources` | Lista separada por comas de fuentes de configuración a cargar (`user`, `project`, `local`) | `fuxi --setting-sources user,project` |
| `--settings` | Ruta a un archivo JSON de configuración o una cadena JSON en línea. Los valores que establezca aquí anulan las mismas claves en sus archivos `settings.json` para esta sesión. Las claves que omita mantienen sus valores basados en archivos. Consulte [precedencia de configuración](/es/settings#settings-precedence) | `fuxi --settings ./settings.json` |
| `--strict-mcp-config` | Usar solo servidores MCP de `--mcp-config`, ignorando todas las demás configuraciones de MCP | `fuxi --strict-mcp-config --mcp-config ./mcp.json` |
| `--system-prompt` | Reemplazar todo el indicador del sistema con texto personalizado | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Cargar indicación del sistema desde un archivo, reemplazando el indicador predeterminado | `fuxi --system-prompt-file ./custom-prompt.txt` |
| `--teleport` | Reanudar una [sesión web](/es/fuxi-code-on-the-web) en su terminal local | `fuxi --teleport` |
| `--teammate-mode` | Establecer cómo se muestran los compañeros de [equipo de agente](/es/agent-teams): `in-process` (predeterminado), `auto`, `tmux` o {/* min-version: 2.1.186 */}`iterm2` (agregado en v2.1.186). El predeterminado cambió de `auto` en v2.1.179. Anula la configuración [`teammateMode`](/es/settings#available-settings) para esta sesión. Consulte [Elegir un modo de visualización](/es/agent-teams#choose-a-display-mode) | `fuxi --teammate-mode auto` |
| `--tmux` | Crear una sesión tmux para el worktree. Requiere `--worktree`. Utiliza paneles nativos de iTerm2 cuando están disponibles; pase `--tmux=classic` para tmux tradicional | `fuxi -w feature-auth --tmux` |
| `--tools` | Restringir qué herramientas integradas puede usar Fuxi. Use `""` para deshabilitar todas, `"default"` para todas, o nombres de herramientas como `"Bash,Edit,Read"`. Las herramientas MCP no se ven afectadas; para denegar también esas, use `--disallowedTools "mcp__*"`, o pase `--strict-mcp-config` sin `--mcp-config` para que no se carguen servidores MCP | `fuxi --tools "Bash,Edit,Read"` |
| `--verbose` | Habilitar registro detallado, muestra salida completa turno por turno. Anula la configuración [`viewMode`](/es/settings#available-settings) para esta sesión | `fuxi --verbose` |
| `--version`, `-v` | Mostrar el número de versión | `fuxi -v` |
| `--worktree`, `-w` | Iniciar Fuxi en un [git worktree](/es/worktrees) aislado en `/.fuxi/worktrees/`. Si no se proporciona un nombre, se genera automáticamente. Pase `#` o una URL de solicitud de extracción de GitHub para obtener ese PR de `origin` y ramificar el worktree desde él | `fuxi -w feature-auth` |
Banderas de indicación del sistema
Fuxi Code proporciona cuatro banderas para personalizar el indicador del sistema. Las cuatro funcionan tanto en modo interactivo como no interactivo.
| Bandera | Comportamiento | Ejemplo |
| :---------------------------- | :------------------------------------------------------- | :------------------------------------------------------ |
| `--system-prompt` | Reemplaza todo el indicador predeterminado | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Reemplaza con contenido del archivo | `fuxi --system-prompt-file ./prompts/review.txt` |
| `--append-system-prompt` | Agrega al indicador predeterminado | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Agrega contenido del archivo al indicador predeterminado | `fuxi --append-system-prompt-file ./style-rules.txt` |
`--system-prompt` y `--system-prompt-file` son mutuamente excluyentes. Las banderas de adición se pueden combinar con cualquiera de las banderas de reemplazo.
Elija según si la identidad predeterminada de Fuxi Code aún se ajusta a su tarea. Use una bandera de adición cuando Fuxi deba seguir siendo un asistente de codificación que también sigue sus reglas adicionales: instrucciones por invocación, formato de salida o contexto de dominio para un script `-p`. Agregar preserva la orientación de herramientas predeterminada, instrucciones de seguridad y convenciones de codificación, por lo que solo proporciona lo que difiere. Use una bandera de reemplazo cuando la superficie, identidad o modelo de permiso difiera del de Fuxi Code, como un agente no codificador en una canalización que ningún humano observa. Reemplazar elimina todo el indicador predeterminado, incluida la orientación de herramientas e instrucciones de seguridad, por lo que usted es responsable de lo que su tarea aún necesita.
Estas banderas se aplican solo a la invocación actual. Para personas persistentes que puede cambiar y compartir en un proyecto, use [estilos de salida](/es/output-styles). Para convenciones de proyecto que Fuxi siempre debe seguir, use [FUXI.md](/es/memory). La [guía de Agent SDK sobre indicaciones del sistema](/es/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) cubre la misma decisión con más profundidad.
Ver también
* [Extensión de Chrome](/es/chrome) - Automatización de navegador y pruebas web
* [Modo interactivo](/es/interactive-mode) - Atajos de teclado, modos de entrada y características interactivas
* [Guía de inicio rápido](/es/quickstart) - Introducción a Fuxi Code
* [Flujos de trabajo comunes](/es/common-workflows) - Flujos de trabajo avanzados y patrones
* [Configuración](/es/settings) - Opciones de configuración
* [Documentación de Agent SDK](/es/agent-sdk/overview) - Uso programático e integraciones