> ## 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.
# Referência de CLI
> Referência completa para a interface de linha de comando Fuxi Code, incluindo comandos e sinalizadores.
Comandos CLI
Você pode iniciar sessões, canalizar conteúdo, retomar conversas e gerenciar atualizações com estes comandos:
| Comando | Descrição | Exemplo |
| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| `fuxi` | Iniciar sessão interativa | `fuxi` |
| `fuxi "query"` | Iniciar sessão interativa com prompt inicial | `fuxi "explain this project"` |
| `fuxi -p "query"` | Consultar via SDK e sair | `fuxi -p "explain this function"` |
| `cat file \| fuxi -p "query"` | Processar conteúdo canalizado | `cat logs.txt \| fuxi -p "explain"` |
| `fuxi -c` | Continuar a conversa mais recente no diretório atual | `fuxi -c` |
| `fuxi -c -p "query"` | Continuar via SDK | `fuxi -c -p "Check for type errors"` |
| `fuxi -r "" "query"` | Retomar sessão por ID ou nome | `fuxi -r "auth-refactor" "Finish this PR"` |
| `fuxi update` | Atualizar para a versão mais recente | `fuxi update` |
| `fuxi gateway` | Iniciar o servidor [gateway de aplicativos Fuxi](/pt/fuxi-apps-gateway) auto-hospedado, para administradores implantando SSO e política na frente do Fuxi Code no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Requer `--config` apontando para um [`gateway.yaml`](/pt/fuxi-apps-gateway-config). Disponível no Fuxi Code v2.1.195 e posterior. | `fuxi gateway --config gateway.yaml` |
| `fuxi install [version]` | Instalar ou reinstalar o binário nativo. Aceita uma versão como `2.1.118`, ou `stable` ou `latest`. Veja [Instalar uma versão específica](/pt/setup#install-a-specific-version) | `fuxi install stable` |
| `fuxi auth login` | Faça login em sua conta Anthropic. Use `--email` para preencher previamente seu endereço de email, `--sso` para forçar autenticação SSO e `--console` para fazer login com Anthropic Console para faturamento de uso de API em vez de uma assinatura Fuxi | `fuxi auth login --console` |
| `fuxi auth logout` | Fazer logout de sua conta Anthropic | `fuxi auth logout` |
| `fuxi auth status` | Mostrar status de autenticação como JSON. Use `--text` para saída legível por humanos. Sai com código 0 se conectado, 1 se não | `fuxi auth status` |
| `fuxi agents` | Abrir [visualização de agente](/pt/agent-view) para monitorar e despachar sessões de fundo paralelas. Use `--cwd ` para mostrar apenas sessões iniciadas nesse diretório, ou `--json` para imprimir sessões ativas como um array JSON para scripts (`--json --all` também inclui sessões de fundo concluídas). Passe `--permission-mode`, `--model`, `--effort` ou `--agent` para definir [padrões para sessões despachadas](/pt/agent-view#permission-mode-model-and-effort). Aceita `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` como o comando `fuxi` de nível superior. Abrir visualização de agente requer um terminal interativo | `fuxi agents --json` |
| `fuxi attach ` | Anexar a uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) neste terminal | `fuxi attach 7c5dcf5d` |
| `fuxi auto-mode defaults` | Imprimir as regras do classificador [auto mode](/pt/permission-modes#eliminate-prompts-with-auto-mode) integradas como JSON. Use `fuxi auto-mode config` para ver sua configuração efetiva com as configurações aplicadas | `fuxi auto-mode defaults > rules.json` |
| `fuxi daemon status` | Imprimir o estado do [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução | `fuxi daemon status` |
| `fuxi daemon stop --any` | Parar o [supervisor](/pt/agent-view#the-supervisor-process) de sessão de fundo e as sessões que ele hospeda. Passe `--keep-workers` para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. `--any` confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um [supervisor não responsivo](/pt/agent-view#agent-view-says-the-background-service-did-not-respond) | `fuxi daemon stop --any --keep-workers` |
| `fuxi doctor` | Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Controle Remoto. Para a verificação de configuração em sessão que também pode aplicar correções, execute [`/doctor`](/pt/commands#all-commands) | `fuxi doctor` |
| `fuxi logs ` | Imprimir saída recente de uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) | `fuxi logs 7c5dcf5d` |
| `fuxi mcp` | Configurar servidores Model Context Protocol (MCP) | Veja a [documentação Fuxi Code MCP](/pt/mcp). |
| `fuxi mcp login ` | {/* min-version: 2.1.186 */}Executar o fluxo OAuth de um servidor MCP configurado sem abrir o painel interativo `/mcp`. Funciona para servidores HTTP, SSE e conectores fuxi.ai. Adicione `--no-browser` via SSH para imprimir a URL de autorização em vez de abrir um navegador, depois cole a URL de redirecionamento de volta no prompt. Requer Fuxi Code v2.1.186 ou posterior. Veja [Autenticar a partir da linha de comando](/pt/mcp#authenticate-from-the-command-line) | `fuxi mcp login sentry` |
| `fuxi mcp logout ` | {/* min-version: 2.1.186 */}Limpar credenciais OAuth armazenadas para um servidor MCP. Requer Fuxi Code v2.1.186 ou posterior | `fuxi mcp logout sentry` |
| `fuxi plugin` | Gerenciar Fuxi Code [plugins](/pt/plugins). Alias: `fuxi plugins`. Veja [referência de plugin](/pt/plugins-reference#cli-commands-reference) para subcomandos | `fuxi plugin install code-review@fuxi-plugins-official` |
| `fuxi project purge [path]` | Excluir todo o estado local do Fuxi Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em `~/.fuxi.json`. Omita `[path]` para escolher em uma lista interativa. Sinalizadores: `--dry-run` para visualizar, `-y`/`--yes` para pular confirmação, `-i`/`--interactive` para confirmar cada item, `--all` para cada projeto. Veja [Limpar dados locais](/pt/fuxi-directory#clear-local-data) | `fuxi project purge ~/work/repo --dry-run` |
| `fuxi remote-control` | Iniciar um servidor [Remote Control](/pt/remote-control) para controlar Fuxi Code a partir de Fuxi.ai ou do aplicativo Fuxi. Executa em modo servidor (sem sessão interativa local). Veja [Sinalizadores de modo servidor](/pt/remote-control#start-a-remote-control-session) | `fuxi remote-control --name "My Project"` |
| `fuxi respawn ` | Reiniciar uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell), em execução ou parada, com sua conversa intacta. Use `--all` para reiniciar cada sessão em execução, por exemplo, para pegar um binário Fuxi Code atualizado | `fuxi respawn 7c5dcf5d` |
| `fuxi rm ` | Remover uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell) da lista. A transcrição da conversa permanece em sua máquina local, disponível através de `fuxi --resume` | `fuxi rm 7c5dcf5d` |
| `fuxi setup-token` | Gerar um token OAuth de longa duração para CI e scripts. Imprime o token no terminal sem salvá-lo. Requer uma assinatura Fuxi. Veja [Gerar um token de longa duração](/pt/authentication#generate-a-long-lived-token) | `fuxi setup-token` |
| `fuxi stop ` | Parar uma [sessão de fundo](/pt/agent-view#manage-sessions-from-the-shell). Também aceita `fuxi kill` | `fuxi stop 7c5dcf5d` |
| `fuxi ultrareview [target]` | Executar [ultrareview](/pt/ultrareview#run-ultrareview-non-interactively) de forma não interativa. Imprime descobertas para stdout e sai com 0 em caso de sucesso ou 1 em caso de falha. Use `--json` para o payload bruto e `--timeout ` para substituir o padrão de 30 minutos | `fuxi ultrareview 1234 --json` |
Se você digitar incorretamente um subcomando, Fuxi Code sugere a correspondência mais próxima e sai sem iniciar uma sessão. Por exemplo, `fuxi udpate` imprime `Did you mean fuxi update?`.
{/* min-version: 2.1.199 */}A partir da v2.1.199, `fuxi --dangerously-skip-permissions daemon ` executa o subcomando `daemon`. Versões anteriores tratavam `daemon ` como o prompt para uma nova sessão interativa, então o subcomando nunca era executado quando a flag vinha primeiro, uma configuração comum quando `fuxi` é aliasado para incluir a flag. Apenas um `--dangerously-skip-permissions` ou `--allow-dangerously-skip-permissions` à frente roteia para `daemon` desta forma; qualquer outra flag à frente ainda inicia uma sessão interativa.
Sinalizadores CLI
Personalize o comportamento do Fuxi Code com estes sinalizadores de linha de comando. `fuxi --help` não lista todos os sinalizadores, portanto a ausência de um sinalizador em `--help` não significa que ele não está disponível.
| Sinalizador | Descrição | Exemplo |
| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
| `--add-dir` | Adicionar diretórios de trabalho adicionais para Fuxi ler e editar arquivos. Concede acesso a arquivos; a maioria da configuração `.fuxi/` [não é descoberta](/pt/permissions#additional-directories-grant-file-access-not-configuration) desses diretórios. Valida se cada caminho existe como um diretório. Para persistir esses diretórios entre sessões, defina [`permissions.additionalDirectories`](/pt/settings#permission-settings) nas configurações | `fuxi --add-dir ../apps ../lib` |
| `--advisor ` | Ativar a [ferramenta advisor](/pt/advisor) do lado do servidor para esta sessão com um alias de modelo: `opus`, `sonnet` ou `fable` ({/* min-version: 2.1.170 */}v2.1.170+), ou um ID de modelo completo. Tem precedência sobre a configuração `advisorModel` para a sessão | `fuxi --advisor opus` |
| `--agent` | Especificar um agente para a sessão atual (substitui a configuração `agent`) | `fuxi --agent my-custom-agent` |
| `--agents` | Definir subagents personalizados dinamicamente via JSON. Usa os mesmos nomes de campo que o [frontmatter](/pt/sub-agents#supported-frontmatter-fields) de subagent, mais um campo `prompt` para as instruções do agente | `fuxi --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
| `--allow-dangerously-skip-permissions` | Adicionar `bypassPermissions` ao ciclo de modo `Shift+Tab` sem iniciar nele. Permite começar em um modo diferente como `plan` e mudar para `bypassPermissions` depois. Veja [modos de permissão](/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `fuxi --permission-mode plan --allow-dangerously-skip-permissions` |
| `--allowedTools`, `--allowed-tools` | Ferramentas que executam sem solicitar permissão. Veja [sintaxe de regra de permissão](/pt/settings#permission-rule-syntax) para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use `--tools` em vez disso | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Anexar texto personalizado ao final do prompt do sistema de cada [subagent](/pt/sub-agents), incluindo subagents aninhados. Aplica-se apenas em modo não interativo com `-p`. Requer Fuxi Code v2.1.205 ou posterior | `fuxi -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |
| `--append-system-prompt` | Anexar texto personalizado ao final do prompt do sistema padrão | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão | `fuxi --append-system-prompt-file ./extra-rules.txt` |
| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Força o renderizador clássico, portanto a configuração [`tui`](/pt/settings#available-settings) não tem efeito; sessões [background](/pt/agent-view) anexadas ainda renderizam em tela cheia. Tem precedência sobre [`FUXI_AX_SCREEN_READER`](/pt/env-vars) e a configuração [`axScreenReader`](/pt/settings#available-settings). Requer Fuxi Code v2.1.181 ou posterior | `fuxi --ax-screen-reader` |
| `--bare` | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e FUXI.md para que chamadas com script iniciem mais rapidamente. Fuxi tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define [`FUXI_CODE_SIMPLE`](/pt/env-vars). Veja [modo bare](/pt/headless#start-faster-with-bare-mode) | `fuxi --bare -p "query"` |
| `--betas` | Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) | `fuxi --betas interleaved-thinking` |
| `--bg`, `--background` | Iniciar a sessão como um [agente de fundo](/pt/agent-view) e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com `--exec` para executar um comando shell como um trabalho de fundo em vez de uma sessão Fuxi, ou com `--agent` para executar um subagent específico. {/* min-version: 2.1.198 */}Não pode ser combinado com `-p`/`--print`; veja a [referência de erro](/pt/errors#command-line-errors) | `fuxi --bg "investigate the flaky test"` |
| `--channels` | (Visualização de pesquisa) Servidores MCP cujas notificações de [channel](/pt/channels) Fuxi deve ouvir nesta sessão. Lista separada por espaço de entradas `plugin:@`. Requer autenticação Fuxi.ai | `fuxi --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | Ativar [integração do navegador Chrome](/pt/chrome) para automação web e testes | `fuxi --chrome` |
| `--cloud` | Criar uma nova [sessão web](/pt/fuxi-code-on-the-web) em fuxi.ai com a descrição de tarefa fornecida | `fuxi --cloud "Fix the login bug"` |
| `--continue`, `-c` | Carregar a conversa mais recente no diretório atual. Inclui sessões que adicionaram este diretório com `/add-dir` | `fuxi --continue` |
| `--dangerously-load-development-channels` | Ativar [channels](/pt/channels-reference#test-during-the-research-preview) que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas `plugin:@` e `server:`. Solicita confirmação | `fuxi --dangerously-load-development-channels server:webhook` |
| `--dangerously-skip-permissions` | Pular prompts de permissão. Equivalente a `--permission-mode bypassPermissions`. Veja [modos de permissão](/pt/permission-modes#skip-all-checks-with-bypasspermissions-mode) para o que isso faz e não faz | `fuxi --dangerously-skip-permissions` |
| `--debug` | Ativar modo de depuração com filtragem de categoria opcional (por exemplo, `"api,hooks"` ou `"!statsig,!file"`) | `fuxi --debug "api,mcp"` |
| `--debug-file ` | Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre `FUXI_CODE_DEBUG_LOGS_DIR` | `fuxi --debug-file /tmp/fuxi-debug.log` |
| `--disable-slash-commands` | Desativar todas as skills e comandos para esta sessão | `fuxi --disable-slash-commands` |
| `--disallowedTools`, `--disallowed-tools` | Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do modelo: `"Edit"` remove Edit, `"*"` remove todas as ferramentas e `"mcp__*"` remove todas as ferramentas MCP. Uma regra com escopo como `Bash(rm *)` deixa a ferramenta disponível e nega apenas chamadas correspondentes | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
| `--effort` | Definir o [nível de esforço](/pt/model-config#adjust-effort-level) para a sessão atual. Opções: `low`, `medium`, `high`, `xhigh`, `max` ou {/* min-version: 2.1.203 */}}`ultracode`. Os níveis disponíveis dependem do modelo. `ultracode` inicia a sessão em esforço `xhigh` com [ultracode](/pt/workflows#let-fuxi-decide-with-ultracode) ativado e requer Fuxi Code v2.1.203 ou posterior. Substitui a configuração [`effortLevel`](/pt/settings#available-settings) para esta sessão e não persiste | `fuxi --effort high` |
| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Removido em v2.1.111. Auto mode agora está no ciclo `Shift+Tab` por padrão; use `--permission-mode auto` para iniciar nele | `fuxi --permission-mode auto` |
| `--exclude-dynamic-system-prompt-sections` | Mover seções por máquina do prompt do sistema (diretório de trabalho, informações de ambiente, caminhos de memória, status do git) para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando `--system-prompt` ou `--system-prompt-file` está definido. Use com `-p` para cargas de trabalho com script e multi-usuário | `fuxi -p --exclude-dynamic-system-prompt-sections "query"` |
| `--exec` | Executar um comando shell como um trabalho de fundo com suporte PTY em vez de iniciar uma sessão Fuxi. Use com `--bg` para iniciar a partir do shell | `fuxi --bg --exec 'pytest -x'` |
| `--fallback-model` | Ativar fallback automático para o(s) modelo(s) especificado(s) quando o modelo primário está sobrecarregado ou não está disponível, por exemplo um modelo descontinuado. Aceita uma lista separada por vírgula tentada em ordem. Veja [Cadeias de modelo fallback](/pt/model-config#fallback-model-chains). Para persistir uma cadeia entre sessões, use a configuração [`fallbackModel`](/pt/settings#available-settings), que este sinalizador substitui | `fuxi --fallback-model sonnet,haiku` |
| `--fork-session` | Ao retomar, criar um novo ID de sessão em vez de reutilizar o original (use com `--resume` ou `--continue`) | `fuxi --resume abc123 --fork-session` |
| `--from-pr` | Retomar sessões vinculadas a um pull request específico. Aceita um número de PR, uma URL de PR do GitHub ou GitHub Enterprise, uma URL de merge request do GitLab ou uma URL de pull request do Bitbucket. As sessões são vinculadas automaticamente quando Fuxi cria o pull request | `fuxi --from-pr 123` |
| `--ide` | Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível | `fuxi --ide` |
| `--init` | Executar hooks de [Setup](/pt/hooks#setup) com o matcher `init` antes da sessão (apenas modo print) | `fuxi -p --init "query"` |
| `--init-only` | Executar hooks de [Setup](/pt/hooks#setup) e `SessionStart`, depois sair sem iniciar uma conversa | `fuxi --init-only` |
| `--include-hook-events` | Incluir todos os eventos do ciclo de vida do hook no fluxo de saída. Requer `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-hook-events "query"` |
| `--include-partial-messages` | Incluir eventos de streaming parcial na saída. Requer `--print` e `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-partial-messages "query"` |
| `--input-format` | Especificar formato de entrada para modo print (opções: `text`, `stream-json`) | `fuxi -p --output-format json --input-format stream-json` |
| `--json-schema` | Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja [saídas estruturadas](/pt/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Fuxi Code sai com um erro em um schema inválido e aceita a palavra-chave `format` como uma anotação sem validação do lado do cliente. Antes de v2.1.205, um schema inválido produzia saída não estruturada sem erro, e schemas usando `format` eram tratados como inválidos | `fuxi -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | Executar hooks de [Setup](/pt/hooks#setup) com o matcher `maintenance` antes da sessão (apenas modo print) | `fuxi -p --maintenance "query"` |
| `--max-budget-usd` | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print) | `fuxi -p --max-budget-usd 5.00 "query"` |
| `--max-turns` | Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. {/* min-version: 2.1.205 */}Com `--input-format stream-json`, uma mensagem enviada enquanto Fuxi está trabalhando fica na fila e é executada como seu próprio turno, com seu próprio limite, quando o limite termina o atual. Antes de v2.1.205, Fuxi Code descartava essa mensagem | `fuxi -p --max-turns 3 "query"` |
| `--mcp-config` | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço) | `fuxi --mcp-config ./mcp.json` |
| `--model` | Define o modelo para a sessão atual com um alias para o modelo mais recente (`sonnet`, `opus`, `haiku` ou `fable`) ou o nome completo de um modelo. Substitui a configuração [`model`](/pt/settings#available-settings) e [`ANTHROPIC_MODEL`](/pt/model-config#environment-variables) | `fuxi --model fuxi-sonnet-5` |
| `--name`, `-n` | Definir um nome de exibição para a sessão, mostrado em `/resume` e no título do terminal. Você pode retomar uma sessão nomeada com `fuxi --resume `.
[`/rename`](/pt/commands) altera o nome durante a sessão e também o mostra na barra de prompt | `fuxi -n "my-feature-work"` |
| `--no-chrome` | Desativar [integração do navegador Chrome](/pt/chrome) para esta sessão | `fuxi --no-chrome` |
| `--no-session-persistence` | Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente [`FUXI_CODE_SKIP_PROMPT_HISTORY`](/pt/env-vars) faz o mesmo em qualquer modo | `fuxi -p --no-session-persistence "query"` |
| `--output-format` | Especificar formato de saída para modo print (opções: `text`, `json`, `stream-json`) | `fuxi -p "query" --output-format json` |
| `--permission-mode` | Começar em um [modo de permissão](/pt/permission-modes) especificado. Aceita `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` ou {/* min-version: 2.1.200 */}}`manual` como um alias para `default`. O alias `manual` seleciona o modo que a UI rotula como Manual e requer Fuxi Code v2.1.200 ou posterior; `fuxi --help` o lista no lugar de `default` e ambos os valores funcionam. Substitui `defaultMode` dos arquivos de configuração | `fuxi --permission-mode plan` |
| `--permission-prompt-tool` | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. {/* min-version: 2.1.199 */}A partir de v2.1.199, a ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como [exigindo interação do usuário](/pt/mcp#require-approval-for-a-specific-tool): um resultado `allow` para uma é convertido em uma negação | `fuxi -p --permission-prompt-tool mcp_auth_tool "query"` |
| `--plugin-dir` | Carregar um plugin de um diretório ou arquivo `.zip` apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para vários plugins: `--plugin-dir A --plugin-dir B.zip` | `fuxi --plugin-dir ./my-plugin` |
| `--plugin-url` | Buscar um arquivo `.zip` de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas | `fuxi --plugin-url https://example.com/plugin.zip` |
| `--print`, `-p` | Imprimir resposta sem modo interativo (veja [documentação do Agent SDK](/pt/agent-sdk/overview) para detalhes de uso programático) | `fuxi -p "query"` |
| `--prompt-suggestions` | Emitir uma mensagem `prompt_suggestion` após cada turno com um prompt de usuário previsto. Requer `--print`, `--output-format stream-json` e `--verbose`. Veja [Sugestões de prompt](/pt/interactive-mode#prompt-suggestions) | `fuxi -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | Alias descontinuado para `--cloud` | `fuxi --remote "Fix the login bug"` |
| `--remote-control`, `--rc` | Iniciar uma sessão interativa com [Remote Control](/pt/remote-control#start-a-remote-control-session) ativado para que você também possa controlá-la a partir de fuxi.ai ou do aplicativo Fuxi. Opcionalmente, passe um nome para a sessão | `fuxi --remote-control "My Project"` |
| `--remote-control-session-name-prefix ` | Prefixo para nomes de sessão [Remote Control](/pt/remote-control) gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como `myhost-graceful-unicorn`. Defina `FUXI_REMOTE_CONTROL_SESSION_NAME_PREFIX` para o mesmo efeito | `fuxi remote-control --remote-control-session-name-prefix dev-box` |
| `--replay-user-messages` | Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer `--input-format stream-json` e `--output-format stream-json` | `fuxi -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |
| `--resume`, `-r` | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com `/add-dir`; passar um ID de sessão pesquisa apenas o diretório do projeto atual e seus git worktrees. A partir de v2.1.144, [sessões de fundo](/pt/agent-view) aparecem no seletor marcadas com `bg` | `fuxi --resume auth-refactor` |
| `--safe-mode` | {/* min-version: 2.1.169 */}Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: FUXI.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de [`--bare`](/pt/headless#start-faster-with-bare-mode). A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, FUXI.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara [fallback automático de Fable 5](/pt/model-config#automatic-model-fallback). Define [`FUXI_CODE_SAFE_MODE`](/pt/env-vars) | `fuxi --safe-mode` |
| `--session-id` | Usar um ID de sessão específico para a conversa (deve ser um UUID válido) | `fuxi --session-id "550e8400-e29b-41d4-a716-446655440000"` |
| `--setting-sources` | Lista separada por vírgula de fontes de configuração a carregar (`user`, `project`, `local`) | `fuxi --setting-sources user,project` |
| `--settings` | Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais. Os valores que você define aqui substituem as mesmas chaves em seus arquivos `settings.json` para esta sessão. As chaves que você omite mantêm seus valores baseados em arquivo. Veja [precedência de configurações](/pt/settings#settings-precedence) | `fuxi --settings ./settings.json` |
| `--strict-mcp-config` | Usar apenas servidores MCP de `--mcp-config`, ignorando todas as outras configurações de MCP | `fuxi --strict-mcp-config --mcp-config ./mcp.json` |
| `--system-prompt` | Substituir todo o prompt do sistema por texto personalizado | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão | `fuxi --system-prompt-file ./custom-prompt.txt` |
| `--teleport` | Retomar uma [sessão web](/pt/fuxi-code-on-the-web) em seu terminal local | `fuxi --teleport` |
| `--teammate-mode` | Definir como [equipe de agentes](/pt/agent-teams) colegas de equipe são exibidos: `in-process` (padrão), `auto`, `tmux` ou {/* min-version: 2.1.186 */}}`iterm2` (adicionado em v2.1.186). O padrão mudou de `auto` em v2.1.179. Substitui a configuração [`teammateMode`](/pt/settings#available-settings) para esta sessão. Veja [Escolher um modo de exibição](/pt/agent-teams#choose-a-display-mode) | `fuxi --teammate-mode auto` |
| `--tmux` | Criar uma sessão tmux para o worktree. Requer `--worktree`. Usa painéis nativos do iTerm2 quando disponível; passe `--tmux=classic` para tmux tradicional | `fuxi -w feature-auth --tmux` |
| `--tools` | Restringir quais ferramentas integradas Fuxi pode usar. Use `""` para desativar todas, `"default"` para todas, ou nomes de ferramentas como `"Bash,Edit,Read"`. Ferramentas MCP não são afetadas; para negar essas também, use `--disallowedTools "mcp__*"` ou passe `--strict-mcp-config` sem `--mcp-config` para que nenhum servidor MCP carregue | `fuxi --tools "Bash,Edit,Read"` |
| `--verbose` | Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração [`viewMode`](/pt/settings#available-settings) para esta sessão | `fuxi --verbose` |
| `--version`, `-v` | Exibir o número da versão | `fuxi -v` |
| `--worktree`, `-w` | Iniciar Fuxi em um [git worktree](/pt/worktrees) isolado em `/.fuxi/worktrees/`. Se nenhum nome for fornecido, um será gerado automaticamente. Passe `#` ou uma URL de pull request do GitHub para buscar esse PR de `origin` e ramificar o worktree a partir dele | `fuxi -w feature-auth` |
Sinalizadores de prompt do sistema
Fuxi Code fornece quatro sinalizadores para personalizar o prompt do sistema. Todos os quatro funcionam em modos interativo e não interativo.
| Sinalizador | Comportamento | Exemplo |
| :---------------------------- | :----------------------------------------- | :------------------------------------------------------ |
| `--system-prompt` | Substitui todo o prompt padrão | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Substitui pelo conteúdo do arquivo | `fuxi --system-prompt-file ./prompts/review.txt` |
| `--append-system-prompt` | Anexa ao prompt padrão | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Anexa conteúdo do arquivo ao prompt padrão | `fuxi --append-system-prompt-file ./style-rules.txt` |
`--system-prompt` e `--system-prompt-file` são mutuamente exclusivos. Os sinalizadores de anexação podem ser combinados com qualquer sinalizador de substituição.
Escolha com base em se a identidade padrão do Fuxi Code ainda se adequa à sua tarefa. Use um sinalizador de anexação quando Fuxi deve permanecer um assistente de codificação que também segue suas regras extras: instruções por invocação, formatação de saída ou contexto de domínio para um script `-p`. Anexar preserva a orientação de ferramentas padrão, instruções de segurança e convenções de codificação, portanto você fornece apenas o que difere. Use um sinalizador de substituição quando a superfície, identidade ou modelo de permissão diferir do Fuxi Code, como um agente não codificador em um pipeline que nenhum humano observa. Substituir descarta todo o prompt padrão, incluindo orientação de ferramentas e instruções de segurança, portanto você assume a responsabilidade por tudo o que sua tarefa ainda precisa.
Esses sinalizadores se aplicam apenas à invocação atual. Para personas persistentes que você pode alternar e compartilhar em um projeto, use [estilos de saída](/pt/output-styles). Para convenções de projeto que Fuxi deve sempre seguir, use [FUXI.md](/pt/memory). O [guia do Agent SDK sobre prompts do sistema](/pt/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) cobre a mesma decisão com mais profundidade.
Veja também
* [Extensão Chrome](/pt/chrome) - Automação de navegador e testes web
* [Modo interativo](/pt/interactive-mode) - Atalhos de teclado, modos de entrada e recursos interativos
* [Guia de início rápido](/pt/quickstart) - Começar com Fuxi Code
* [Fluxos de trabalho comuns](/pt/common-workflows) - Fluxos de trabalho e padrões avançados
* [Configurações](/pt/settings) - Opções de configuração
* [Documentação do Agent SDK](/pt/agent-sdk/overview) - Uso programático e integrações