Como usar comandos CLI para telefones em nuvem

Escrito por Darles B ( Atualizado em 6 de Outubro de 2026 )

Atualizado em 6 de Outubro de 2026

Use a CLI do Multilogin para criar, atualizar, iniciar, parar, organizar, transferir e gerenciar telefones em nuvem Android pela linha de comando.

Para ver os comandos disponíveis atualmente no seu dispositivo, execute xcli --help no Windows ou ./xcli --help no macOS/Linux.

Antes de começar: inicie a CLI do Multilogin e entre na sua conta. Se você ainda não usa a CLI, consulte “Como começar a usar a CLI”.

Usando a CLI como membro da equipe? Os comandos disponíveis dependem da sua função no espaço de trabalho e do seu acesso às pastas.

Passo 1: inicie o CLI

Inicie Multilogin, depois abra o Prompt de Comando ou Terminal, vá para a pasta CLI e execute o executável CLI:

Windows

Vá para a pasta CLI:
```
C:/Users/%username%/mlx/deps/cli
```
Execute xcli.exe

macOS

Vá para a pasta CLI:
```
/Users/%username%/mlx/deps/cli
```
Execute ./xcli:
```
./xcli
```

Linux

Vá para a pasta CLI:
```
/Home/%username%/mlx/deps/cli
```
Execute ./xcli:
```
./xcli
```

Siga o artigo para mais detalhes: Como começar a trabalhar com CLI.

Entre na sua conta para autenticar sua sessão da CLI.

Windows

Cole este prompt para fazer login:

xcli login --username 'seu nome de usuário' --password 'sua senha'

Substitua os valores das flags (--username e --password) pelo seu email e senha

macOS

Cole este prompt para fazer login:

./xcli login --username 'seu nome de usuário' --password 'sua senha'

Substitua os valores das flags (--username e --password) pelo seu email e senha

Linux

Cole este prompt para fazer login:

./xcli login --username 'seu nome de usuário' --password 'sua senha'

Substitua os valores das flags (--username e --password) pelo seu email e senha

Em seguida, role até “Mobile Profile Commands”. Esta seção contém os comandos que você pode usar para os telefones em nuvem.

Pronto para executar seus primeiros comandos de telefone em nuvem? Comece com estes guias:

Comandos de telefone em nuvem

Quer fazer algo específico? Use a tabela abaixo para encontrar o comando certo:

Comando CLI	Descrição	Flags necessárias	Notas
`mobile-profiles-limit`	obtém o limite de telefones em nuvem	N/A
`mobile-profiles-group`	obtém um grupo de telefones em nuvem existente ou cria um novo	N/A	Retorna o grupo de perfil móvel para o workspace atual. Se nenhum grupo existir ainda, um é criado automaticamente.
`mobile-profiles-states`	obtém estados por país	`--country`	Serão usadas siglas ISO. Por exemplo, `USA` e `GBR` para os EUA e Reino Unido, respectivamente.
`mobile-profiles-cities`	obtém cidades por estado	`--state`	Use o nome do estado retornado por `mobile-profiles-states`, por exemplo, "Alabama" ou "Califórnia".
`mobile-profiles-proxy-check`	verifica a configuração do proxy	`--detect-type` `--port` `--proxy-type` `--server`	`--detect-type` define o serviço de detecção via IP2Location (por padrão) ou IP-API. Defina a porta do proxy. A porta padrão é 1080. Escolha o tipo de proxy: socks5 ou http. O tipo padrão é socks5. Defina o endereço do servidor ao lado da flag `--server`.
`mobile-profiles-phone-brand-list`	obtém lista de marcas de telefone por versão do Android	`--android-version`	Defina o número para a flag `--android-version` (ex.: 12, 13, 14, 15, 16).
`mobile-profiles-phone-list`	obtém a lista de telefones em nuvem com filtros	N/A	Existem valores adicionais para filtrar o resultado da pesquisa. Use a flag `--help` para isso.
`mobile-profiles-create`	cria novos telefones em nuvem	`--mobile-type` `--phone-name` `--proxy`	Defina a versão do SO com a flag `--mobile-type`, por exemplo, “Android 12”. Para proxy, adicione a string de proxy completa, por exemplo: socks5://user:pass@host:port Você também pode definir valores extras, como geolocalização, marca e modelo. Use a flag `--help` para vê-los.
`mobile-profiles-update`	atualiza telefones em nuvem	`--id` `--phone-name`	Use o ID do telefone em nuvem com a flag `--id`. Você também pode editar proxy, notas e tags. Use a flag `--help` para ver todas as opções.
`mobile-profiles-delete`	exclui telefones em nuvem por ID	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgula. Por exemplo: "1,2,3"
`mobile-profiles-statuses`	obtém os status dos telefones em nuvem	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgulas. Por exemplo: "1,2,3"
`mobile-profiles-tag-assign`	atribui tags aos telefones em nuvem	`--profile-id` `--tags`	Você pode adicionar até 10 tags.
`mobile-profiles-tag-unassign`	remove tags dos telefones em nuvem	`--profile-id` `--tags`
`mobile-phone-shutdown`	desliga telefones em nuvem	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgulas. Por exemplo: “1,2,3”
`mobile-phone-launch`	inicia telefones em nuvem	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgula. Por exemplo: “1,2,3”
`mobile-profiles-app-list`	obtém a lista de aplicativos disponíveis para telefones em nuvem	N/A	Você pode usar valores extras para filtrar os resultados. Use a flag `--help` para vê-los.
`mobile-profiles-app-install`	instala aplicativos em lote em um grupo de telefones em nuvem	`--id` `--version_id`	`--id` é o ID do aplicativo. `--version_id` é o ID da versão do aplicativo. Você pode obter ambos os valores com o comando `mobile-profiles-app-list`.
`mobile-profiles-phone-start`	inicia a chamada de proxy do telefone em nuvem (inicia o telefone sem GUI)	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgula. Por exemplo: “1,2,3”
`mobile-profiles-phone-stop`	interrompe a chamada de proxy do telefone em nuvem (interrompe o telefone sem GUI)	`--ids`	Separe a lista de IDs de telefone em nuvem com vírgula. Por exemplo: “1,2,3”
`mobile-profiles-phone-import-template`	baixa o modelo Excel para importação de perfil	N/A	Defina um caminho de exportação personalizado com a flag `--output`. Por padrão, os arquivos são salvos em `/mlx/deps/cli/`
`mobile-profiles-phone-import-validate`	valida o arquivo de importação de perfis móveis	`--file`	`--file` define o caminho para o arquivo Excel que você deseja validar.
`mobile-profiles-phone-export`	exporta o telefone em nuvem para um arquivo Excel	`--ids`	Defina um caminho de exportação personalizado com a flag `--output`. Por padrão, os arquivos são salvos em `/mlx/deps/cli/` `--ids` define quantos perfis exportar. Você pode exportar de 1 a 200 perfis.
`mobile-profiles-files-list`	lista os arquivos enviados do telefone em nuvem	`--page`	Defina o número da página. A página 1 é usada por padrão. Você pode usar valores extras para filtrar os resultados. Use a flag `--help` para vê-los.
`mobile-profiles-files-upload`	envia um arquivo para a unidade do telefone em nuvem	`--file`	`--file` define o caminho para o arquivo. Use `--help para ver os tipos de arquivo suportados.`
`mobile-profiles-files-delete`	exclui arquivos da unidade do telefone em nuvem por ID	`--ids`	Separe a lista de IDs de arquivo com vírgulas. Por exemplo: “1,2,3”. Você pode obter IDs de arquivo de `mobile-profiles-files-list`.
`mobile-profiles-files-tag-assign`	atribui tags aos arquivos do telefone em nuvem	`--material-id` `--tags`	`--material-id` define o id do arquivo. Você pode obter IDs de arquivo com o comando `mobile-profiles-files-list`. Você pode adicionar até 10 tags.
`mobile-profiles-files-tag-unassign`	remove tags dos arquivos do telefone em nuvem	`--material-id` `--tags`	`--material-id` define o id do arquivo. Você pode obter IDs de arquivo com o comando `mobile-profiles-files-list`. Você pode adicionar até 10 tags.
`mobile-profiles-transfer`	transfere telefones em nuvem para outro usuário	`--ids` `--target-email`	Separe a lista de IDs de arquivo com vírgulas. Por exemplo: “1,2,3”. Você pode transferir até 200 perfis de uma vez. `--target-email` é o endereço de e-mail do destinatário.
`mobile-profiles-adb-set`	define o estado do ADB em telefones em nuvem em execução	`--ids`	Você deve definir a flag `--enable` ou `--disable` para gerenciar a funcionalidade ADB.
`mobile-profiles-adb-info`	obtém os dados de conexão ADB dos telefones em nuvem	`--ids`	Retorna informações como o estado do telefone em nuvem, IP, porta e senha (`pwd`). Eles são importantes para conectar ADB no terminal.