Opções de linha de comando

As opções de linha de comando alteram como o IaC Code é iniciado. Use-as antes de entrar no REPL interativo, ou combine-as com --prompt para automação única.

Opção	Finalidade
-h, --help	Mostrar a ajuda do CLI e sair. Use para verificar as opções suportadas pela versão instalada.
-v, -V, --version	Exibir a versão instalada do IaC Code e sair.
-m <model>, --model <model>	Iniciar com um modelo LLM específico. Substitui o modelo salvo para a execução atual.
-p <prompt>, --prompt <prompt>	Executar um único prompt e sair. Ativa o modo não interativo. Use --prompt - para ler o prompt da entrada padrão.
--output-format <format>	Definir o formato de saída para o modo não interativo. Os valores suportados são text, json e stream-json. O padrão é text.
--max-turns <number>	Limitar o número máximo de turnos do agente no modo não interativo. O padrão é 100.
--thinking-enabled, --no-thinking-enabled	Controla se solicitações nao interativas de execucao unica habilitam thinking explicitamente. O padrão é --thinking-enabled; use --no-thinking-enabled para enviar thinking_enabled=false nesta execução sem reescrever settings.yml.
-d, --debug	Ativar o registro de depuração para a execução atual. No modo interativo, use /debug para inspecionar ou alterar o registro de depuração após a inicialização.
--verbose	Mostrar o progresso do modo headless (não interativo) na saída de erro padrão.
-r <id-ou-nome-da-sessao>, --resume <id-ou-nome-da-sessao>	Retomar uma sessão anterior por ID exato, prefixo único de ID ou nome único de sessão. Sessões resolvidas em outro projeto imprimem um comando cd ... && iac-code --resume <id> em vez de trocar o projeto atual em tempo real.
-c, --continue	Retomar a sessão mais recente. Não pode ser usado junto com --resume.
--allowed-tools <patterns>	Padrões de permissão de ferramentas separados por vírgulas para permitir, ex. 'bash(git *),write_file'.
--disallowed-tools <patterns>	Padrões de permissão de ferramentas separados por vírgulas para negar, ex. 'bash(rm *)'.
--permission-mode <mode>	Modo de permissão: default, accept_edits, bypass_permissions, dont_ask.

Modos de permissão

O parâmetro --permission-mode controla como o agente lida com as verificações de permissão de ferramentas:

Modo	Comportamento
default	O agente solicita confirmação quando uma ação de ferramenta requer aprovação.
accept_edits	Aprovar automaticamente comandos do sistema de arquivos considerados como edições (ex. mkdir, cp). Outras ações ainda solicitam confirmação.
bypass_permissions	Aprovar automaticamente ações de ferramentas exceto verificações de segurança. Toda decisão allow que exige um registro de auditoria falha de forma fechada se a persistência de auditoria falhar. Destinado para automação confiável.
dont_ask	Negar silenciosamente qualquer ação que normalmente solicitaria confirmação. Útil para execuções estritamente somente leitura.

Chamadas de API de escrita Alibaba Cloud feitas por aliyun_api são protegidas separadamente: uma regra allow simples aliyun_api não as aprova globalmente, e fora de bypass_permissions as regras allow de escrita devem corresponder exatamente ao par canônico product:action. bypass_permissions as aprova automaticamente, mas, como outras decisões allow auditadas, a ação é negada se o registro de auditoria de permissões não puder ser persistido. Use regras exatas como aliyun_api(ros:CreateStack) quando a automação confiável deve permitir apenas uma API de escrita específica.

Comandos de inicialização comuns

Iniciar o REPL interativo com o modelo salvo:

iac-code

Iniciar com um modelo específico para esta execução:

iac-code --model qwen3.7-max

Executar um prompt único:

iac-code --prompt "Create an OSS Bucket"

Executar um prompt único com thinking desabilitado para esta solicitação:

iac-code --prompt "Create an OSS Bucket" --no-thinking-enabled

Ler o prompt da entrada padrão:

echo "Create a VPC and two ECS instances" | iac-code --prompt -

Retomar a sessão mais recente:

iac-code --continue

Permitir apenas comandos git e bash somente leitura:

iac-code --allowed-tools 'bash(git *)'

Permitir uma API de escrita Alibaba Cloud específica:

iac-code --allowed-tools 'aliyun_api(ros:CreateStack)'

Executar em automação sem prompts interativos:

iac-code --prompt "Create a VPC" --permission-mode bypass_permissions