Saltar para o conteúdo
← Inforjota
Cursos Inforjota English

Lição 2 de 8 · 15 min · Verificado em 6 de Outubro de 2026

Instalar e entrar: Claude Code e Codex no Windows, Mac e Linux

No fim desta lição vais conseguir:

  • Criar a pasta descartável experiencias e trabalhar sempre dentro dela
  • Instalar o Claude Code, o Codex ou os dois, com os comandos da página oficial
  • Entrar com uma conta ou com uma chave API, pondo antes um tecto de gasto
  • Confirmar que o agente responde e sair dele

A Rita é professora e quer experimentar um agente de código antes do Natal. Ao fim de um quarto de hora tem o agente a responder no terminal, numa pasta sem nada para estragar e com a conta protegida contra surpresas. É isso que fazes nesta lição.

Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome. Os comandos abaixo foram copiados das páginas oficiais nesse dia. Se a página oficial disser outra coisa, ela é que manda.

Antes de começar

  • Uma conta. Para o Claude Code, uma conta Claude ou uma conta na Claude Console (paga por uso). Para o Codex, uma conta ChatGPT ou uma chave API da OpenAI. Que planos dão acesso: consulta a página Estado actual.
  • Um computador recente. Os requisitos mínimos estão na página oficial de cada agente.
  • Node.js? Normalmente não. Só é preciso se instalares com npm (no Claude Code, a versão 22 ou mais recente).
  • No Windows: o Claude Code instala-se no PowerShell (lição 0/01); o Codex, neste curso, dentro do WSL (lição 0/02).

Primeiro: a pasta descartável

Cria a pasta das experiências deste curso (ou entra nela, se já a criaste na lição 0/01).

mkdir experiencias
cd experiencias

Abre sempre o agente a partir daqui. Mas atenção: começar nesta pasta não fecha o agente lá dentro. É o ponto de partida, não uma parede: um comando que aceites pode mexer noutras pastas do computador. Por isso lê cada pedido de licença antes do sim, e nunca abras um agente, para aprender, na pasta dos teus documentos, das fotos ou da contabilidade.

Dica

Não precisas de instalar os dois agentes. Escolhe um para começar; as lições mostram sempre os dois lado a lado.

Instalar o Claude Code

Página oficial: Configurar o Claude Code

No Mac, no Linux ou no WSL:

curl -fsSL https://claude.ai/install.sh | bash

No Windows, no PowerShell:

irm https://claude.ai/install.ps1 | iex

A mesma página tem ainda Homebrew e WinGet. No Windows não precisas de ser administrador.

Para confirmar, fecha o terminal, abre um novo e escreve:

claude --version

Deve aparecer um número de versão. Se algo estiver estranho, claude doctor faz um diagnóstico.

Instalar o Codex

Página oficial: Codex CLI. O código está no repositório do Codex no GitHub.

No Mac, no Linux ou dentro do WSL:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

No Windows, instala o Codex dentro do WSL, como mostra a página oficial Codex no WSL. Se ainda não tens o WSL (lição 0/02), abre o PowerShell como administrador, escreve wsl --install e reinicia se ele pedir. Depois escreve wsl para entrar no Linux e, lá dentro, corre o comando acima. O WSL tem as suas próprias pastas: cria lá também uma experiencias e abre o Codex nela.

Alternativas na mesma página oficial: npm install -g @openai/codex (precisa do Node.js) ou brew install --cask codex.

Cuidado

Estes comandos descarregam um programa e correm-no logo. Copia-os só da página oficial e confirma o endereço letra a letra: claude.ai para o Claude Code, chatgpt.com para o Codex. Nunca de um vídeo, de um email ou de uma mensagem de um desconhecido.

Entrar: conta ou chave

Claude Code (guia: Autenticação no Claude Code). Dentro da pasta experiencias, escreve claude. Da primeira vez abre-se o browser para entrares. Se não abrir, carrega em c para copiar o endereço e cola-o tu no browser. Se aparecer um código, cola-o no terminal. Quando vires «Login successful», carrega em Enter.

Codex (guia: Entrar no Codex). Dentro da pasta experiencias, escreve codex. No ecrã de entrada escolhe Sign in with ChatGPT (abre o browser) ou Use API Key (colas uma chave criada na página API keys da OpenAI). Para ver como estás ligado: codex login status.

Há duas maneiras de pagar, e a diferença importa:

  • Conta com subscrição: pagas uma mensalidade e o uso tem limites dentro dela.
  • Chave API: pagas cada utilização, conforme o que o agente gastar.

Cuidado

Se escolheres a chave API, antes de a usares liga um tecto de gasto na consola do fornecedor. Um agente trabalha sozinho em voltas seguidas e cada volta gasta: um erro que o faz repetir pode gastar muito numa tarde.

  • Alerta: avisa-te quando o gasto chega a um valor, mas o agente continua a gastar.
  • Tecto que bloqueia: ao chegar ao valor, os pedidos são recusados e o agente pára.

Liga o tecto; o alerta é um extra. Deixa folga: a OpenAI avisa que o corte não é instantâneo e que o gasto pode passar um pouco do valor. Com o tecto ligado, a conta fica perto do valor que escolheste, em vez de crescer sem fim.

  • Claude Console: Settings > Billing, secção Spend limits, botão Set limit (ou Adjust limit). Guia: limites de gasto da Anthropic.
  • OpenAI: nos limites da organização ou do projecto, em Spend, Edit spend limit: escreve o valor mensal e liga Enforce a hard limit, a opção que faz os pedidos falharem no limite. Guia: Spend limits da OpenAI.

Dica

A chave API é um segredo. Não a coles em ficheiros que vais partilhar, nem em mensagens, nem em capturas de ecrã. A lição 1/06 explica onde a guardar.

A primeira conversa

Com o agente aberto dentro de experiencias, ele pode perguntar se confias nesta pasta. É tua e está vazia: sim. Depois escreve:

Em que pasta estamos e o que há cá dentro? Não alteres nada.

Para sair: no Claude Code, exit (ou Ctrl + D duas vezes); no Codex, /quit ou /exit. Para ver os comandos disponíveis: /help no Claude Code; no Codex, escreve só / e aparece a lista.

Exercício

Como sei que ficou bem o agente responde com um caminho que termina em experiencias, diz que a pasta está vazia (ou lista o que lá puseste) e não pede licença para alterar nada.

Se não deu

  • «não é reconhecido» ou «command not found»: fecha o terminal e abre um novo. Se continuar, repete a instalação a partir da página oficial; no Claude Code, claude doctor ajuda.
  • No Windows, «'irm' is not recognized»: estás no CMD, não no PowerShell. Abre o PowerShell (Win + X).
  • No Windows, um guia manda-te mudar a «política de execução» (ExecutionPolicy) do PowerShell: não mexas nessa protecção neste curso. Instala o Codex dentro do WSL, como acima.
  • Aparece código HTML ou «syntax error near unexpected token '<'»: o endereço devolveu uma página em vez do instalador. Confirma o endereço e a ligação à Internet.
  • O browser não abriu para entrares: copia o endereço que aparece no terminal e cola-o tu no browser.
  • A conta não tem acesso: consulta a página Estado actual para saber que planos incluem o agente.

Vídeos

Como instalar CLAUDE CODE no seu computador [RÁPIDO!]
Dev Aprender | Jhonatan de Souza · 6 min · PT-BR · legendas · Ver no YouTube
Mostra em 6 minutos como instalar o Claude Code no VS Code, no terminal e na aplicação Desktop, e qual escolher.
Installing Claude Code
Claude · 3 min · EN · legendas · Ver no YouTube
Vídeo oficial da Anthropic sobre instalar o Claude Code no terminal, no VS Code, no JetBrains, no Desktop ou na web.

Testa o que aprendeste

1. Vais usar uma chave API pela primeira vez. O que fazes na consola do fornecedor antes de entrar com ela?
2. Um vídeo mostra um comando de instalação com um endereço diferente do da página oficial. O que fazes?
3. Instalaste o Claude Code e o terminal diz que «claude» não é reconhecido. Qual é a melhor primeira reacção?

Correcções a esta lição (1)
  • : Depois de uma revisão externa: saiu a instrução de desligar a política de execução do Windows (fica a instalação oficial); a pasta deixou de ser apresentada como isolamento; o tecto de gastos passou a ser um limite que bloqueia, separado do alerta, com a nota de que o corte não é instantâneo; nomes dos botões e ligações oficiais corrigidos; saiu a frase «o pior que acontece é parar». As opções do quiz foram reordenadas.