Skip to main content
A CLI do Phaseo é distribuída como @phaseo/cli. Ela conecta ambientes de programação ao Phaseo e oferece um fluxo de trabalho oficial no terminal para o plano de controle do Phaseo. Use-a quando quiser:
  • entrar como usuário do Phaseo em um shell local ou remoto ou em um ambiente de agente
  • criar e alternar chaves de API ou chaves de gerenciamento
  • gerenciar workspaces, predefinições, configurações e proteções
  • usar o OAuth oficial da CLI enquanto os apps OAuth criados por usuários ainda estão em testes privados
  • consultar modelos, provedores, preços, créditos, atividade, análises e gerações

​
Instalar

​
Confira a versão instalada

  • phaseo --version mostra a versão instalada.
  • phaseo version mostra a versão e o comando de atualização recomendado para o gerenciador de pacotes atual.
  • Execuções interativas também mostram uma sugestão de atualização quando há uma versão publicada mais recente.
O comando antigo phaseo continua disponível como alias de compatibilidade.

​
Entrar

Comece com:
A CLI oferece suporte a dois fluxos oficiais:
  • Entrar com Phaseo: OAuth no navegador com código de autorização e PKCE
  • Entrar com código do dispositivo: ideal para SSH, CI, shells sem interface e ambientes de agentes
Você pode forçar qualquer um dos fluxos:
Ambientes remotos e não interativos priorizam automaticamente o código do dispositivo.

​
Saída do terminal

Terminais interativos exibem as cores e a hierarquia visual do Phaseo, além de indicadores temporários durante a configuração. Os indicadores usam stderr e limpam a linha quando o trabalho termina. stderr sem TTY e TERM=dumb desativam animações; NO_COLOR desativa as cores. Comandos com --json sempre retornam uma saída estruturada sem decoração para agentes e automações. Use FORCE_COLOR=1 somente quando um wrapper de terminal oferecer suporte a cores, mas não se identificar como TTY.

​
Confirme sua identidade

Isso retorna seu usuário atual do Phaseo, os escopos, o workspace ativo e os workspaces disponíveis.

​
Criar chaves

Use --json quando um agente ou uma automação precisar receber a chave criada em formato bruto uma única vez.

​
Gerenciar workspaces e proteções

A CLI permite acessar pelo terminal os recursos úteis do painel do Phaseo e das APIs de gerenciamento.

​
Inicie os ambientes de programação compatíveis

Integrações persistentes usam diretamente o nome do produto:
Use --model, --catalog all|default ou --dry-run conforme necessário. A forma antiga phaseo integrations setup <integration> continua disponível por compatibilidade, mas não é necessária. A CLI pode iniciar Cline, Kilo Code, oh-my-pi, Muse Code e MiniMax Code com configuração temporária do provedor e uma chave Phaseo dedicada. Cada ambiente tem um guia com configuração e solução de problemas: Cline, Kilo Code, oh-my-pi, Muse Code e MiniMax Code.
Use phaseo run <cline|kilo|omp|muse|minimax> para a forma explícita. As opções do Phaseo vêm antes de --; as do ambiente vêm depois. Use --catalog all para sincronizar todos os modelos ativos de texto/chat do Phaseo, ou visualize sem criar uma credencial com:
Instalações ausentes de Cline, Kilo Code e oh-my-pi são oferecidas interativamente. Muse Code e MiniMax Code usam seus instaladores oficiais quando o comando não existe. No Windows, MiniMax Code usa o instalador oficial do PowerShell; use --skip-install se gerencia os ambientes separadamente. Os executores não sobrescrevem configurações existentes de Cline, Kilo, oh-my-pi, Muse Code ou MiniMax Code.

​
Aplicativos OAuth

O Phaseo usa um único servidor de autorização OAuth para a CLI oficial, aplicativos criados por usuários e clientes MCP registrados dinamicamente. A CLI usa login pelo navegador ou por código do dispositivo, com tokens de atualização rotativos. Clientes de terceiros usam código de autorização com PKCE, escopos explícitos e consentimento do workspace, tokens de acesso delegados revogáveis e associação opcional a um recurso protegido. A API hospedada do Phaseo habilita OAuth de terceiros. Implantações próprias ou de prévia mantêm o recurso desativado, a menos que PHASEO_THIRD_PARTY_OAUTH_ENABLED receba um valor verdadeiro. São aceitos 1, true, yes e on, sem distinção entre maiúsculas e minúsculas e após remover espaços. A ativação expõe o gerenciamento de apps OAuth criados por usuários e o registro dinâmico de clientes; por isso, revise a configuração de URIs de redirecionamento, consentimento, segredos de cliente, limites de taxa e autorização do workspace.
.env
Docker
Kubernetes

​
Modelo de segurança

Por padrão, as sessões da CLI exigem armazenamento seguro fornecido pelo sistema operacional. Defina PHASEO_SESSION_BACKEND=file explicitamente somente quando não houver um cofre de credenciais do sistema; os tokens de atualização serão armazenados em um arquivo de texto com permissões restritas.
  • phaseo logout revoga o token de atualização armazenado antes de limpar o estado local.
  • Chaves de gerenciamento exigem capacidades explícitas.
  • As chaves comuns de inferência dependem de proteções, políticas de roteamento e configurações do workspace, e não de um modelo de escopos separado.

​
Atualizar

​
Próximas etapas

Última modificação em 2 de outubro de 2026