Instalação e acesso

Prepare o ambiente, conecte sua conta e mantenha o Celo CLI atualizado.

Requisitos do ambiente

O pacote exige Node.js 18.17 ou superior. Para instalações novas, escolha uma versão LTS suportada. Verifique o ambiente antes de instalar:

Terminal

node --version
npm --version

O CLI usa a biblioteca padrão do Node.js. A conexão com a API exige internet e uma conta autorizada.

Instalar ou atualizar

Terminal

npm install -g @celoiaio/cli@latest
celo --version

Se o celo estiver aberto, saia com /sair antes de atualizar. Execute o comando no terminal usando o mesmo ambiente e gerenciador de Node.js da instalação original; depois abra o celo novamente.

Autorizar o terminal

Terminal

celo login
celo whoami

O login usa autorização pelo navegador. Depois da aprovação, o terminal recebe uma chave de API. O comando whoami mostra a conta, o plano, o saldo e a quantidade de modelos disponíveis.

A chave aparece em Configurações › OpenCode / API, com um nome que identifica o Celo CLI e o computador. Revogue-a nessa área se perder o acesso à máquina.

Login em servidor ou SSH

Use CELO_NO_BROWSER para não tentar abrir o navegador local. Acesse o endereço exibido em um dispositivo de confiança.

macOS / Linux / shell POSIX

CELO_NO_BROWSER=1 celo login

Windows PowerShell

$env:CELO_NO_BROWSER = "1"
celo login
Remove-Item Env:CELO_NO_BROWSER

Desconectar ou remover

Terminal

celo logout

Desinstalar o pacote

npm uninstall -g @celoiaio/cli

Desinstalar o pacote não apaga automaticamente os históricos locais em ~/.celo/sessions. Revise esses dados separadamente ao desativar uma máquina.