Pular para o conteúdo principal
Instale @phaseo/cli e execute phaseo login para conectar agentes de programação ao Phaseo e gerenciar chaves, espaços de trabalho, predefinições, configurações e guardrails pelo terminal. A CLI também consulta modelos, provedores, preços, créditos, atividade, análises e gerações.

Instale

Confira a versão: As execuções interativas também mostram um aviso quando uma versão mais nova é publicada.

Entre na sua conta

Ambientes remotos e não interativos usam o código de dispositivo automaticamente. Confira com qual conta você entrou, com seus escopos, o espaço de trabalho ativo e os outros espaços de trabalho:

Gerencie seu espaço de trabalho

Use --json quando um agente ou script ler a saída. A CLI cobre as tarefas do dia a dia da conta; limites de chaves, orçamentos, BYOK, regras de roteamento, predefinições e identidade são alterados no painel ou com uma chave de gerenciamento. Veja Gerencie o Phaseo a partir de um agente para saber quais tarefas a CLI cobre.

Conecte um agente de programação

Use o nome do agente como comando. A CLI pede uma chave dedicada, que você aprova no navegador, e grava a configuração do agente:
Use --model, --catalog all|default ou --dry-run conforme precisar. phaseo setup <agent> e phaseo integrations setup <agent> também funcionam.

Aprove a chave no navegador

Na primeira vez que você configura um agente, a CLI abre uma página do painel da Phaseo e mostra o link dela. A página mostra o workspace, o nome da chave, o limite de gastos mensal de $100 e a expiração após 90 dias, e que a CLI da Phaseo pediu a chave. Escolha Aprovar e criar chave e a CLI recebe a chave uma única vez e conclui a configuração. Se você escolher Recusar, ou deixar a solicitação expirar após 10 minutos, nada é criado. Aprove conectado ao painel com a conta que você usou na CLI, como proprietário ou administrador do workspace e com seu segundo fator, se tiver configurado um. Por SSH ou em CI, abra o link mostrado em qualquer dispositivo em que você esteja conectado. Para usar uma chave que você criou no painel, passe-a com --key <key>, ou com --key-stdin para que ela não fique no histórico do shell. A CLI verifica a chave e a guarda, e não a revoga quando você remove o agente. Para executar o Cline, o Kilo Code, o oh-my-pi, o Muse Code ou o MiniMax Code com configurações temporárias que são apagadas quando ele é encerrado, use o executor de sessão. As flags do Phaseo vêm antes de --, e as do próprio agente, depois:
phaseo run <cline|kilo|omp|muse|minimax> é a forma longa. Adicione --catalog all para listar todos os modelos de texto ativos do Phaseo, ou --dry-run --json para pré-visualizar sem criar uma chave. Os executores oferecem instalar um agente que falte em um terminal interativo (o MiniMax Code usa o instalador oficial do PowerShell no Windows; o Muse Code precisa ser instalado manualmente no Windows). Use --skip-install quando você mesmo gerencia o agente. Agentes de programação lista todos os agentes, o que o comando de cada um faz e o guia correspondente.

Use a CLI em scripts

Comandos com --json mostram uma saída estruturada simples, sem cores nem spinners. Nos demais casos, os spinners vão para stderr e limpam a linha quando terminam.

Como a CLI protege as credenciais

  • As sessões ficam no armazenamento de credenciais do sistema operacional. Defina PHASEO_SESSION_BACKEND=file só se não houver armazenamento de credenciais disponível; isso guarda os refresh tokens em um arquivo em texto puro com permissões restritas.
  • phaseo logout revoga o refresh token guardado antes de limpar o estado local.
  • As chaves de gerenciamento precisam de permissões explícitas. As chaves de inferência são limitadas por guardrails, políticas de roteamento e configurações do espaço de trabalho, e não por escopos.

Apps OAuth

O Phaseo usa um único servidor de autorização OAuth para a CLI, para os apps criados por usuários e para os clientes MCP registrados dinamicamente. A CLI usa login pelo navegador ou por dispositivo, com refresh tokens rotativos. Clientes de terceiros usam código de autorização com PKCE, escopos explícitos e consentimento do espaço de trabalho, além de vinculação opcional a um recurso protegido. Eles recebem um access token revogável que dura 7 dias e um refresh token rotativo que dura 90 dias a partir do último uso; veja Crie um workbench OAuth com Next.js para entender como a renovação funciona. Aprovar o mesmo app de novo renova a chave dele em vez de adicionar uma segunda. A API hospedada do Phaseo tem o OAuth de terceiros ativado. Implantações da API auto-hospedadas e de prévia o mantêm desativado, a menos que PHASEO_THIRD_PARTY_OAUTH_ENABLED tenha um valor verdadeiro: 1, true, yes ou on, sem diferenciar maiúsculas e minúsculas e ignorando espaços ao redor.
.env
Ativá-lo expõe o gerenciamento de apps OAuth criados por usuários e o registro dinâmico de clientes, então revise antes as configurações de URI de redirecionamento, consentimento, segredo do cliente, limite de taxa e autorização do espaço de trabalho.

Atualize

Isso executa a atualização com o gerenciador de pacotes que você usou para instalar a CLI. Para atualizar manualmente:
Última modificação em 9 de novembro de 2026