Guia de Instalação do Zed e do Codex (Sem chave de API)

Este documento reúne, em português, todas as instruções necessárias para instalar o editor Zed e o Codex CLI (repositório openai/codex) em Linux, macOS e Windows. Também explica como configurar um atalho Alt+L para abrir o Codex a partir do VS Code, registra o meu settings.json atual e lista todas as extensões que uso para que qualquer pessoa consiga replicar exatamente o mesmo ambiente.

1. Instalando o Zed

Linux (Flatpak)

1. Certifique-se de que o Flatpak está instalado (em distros Debian/Ubuntu, basta executar sudo apt install flatpak flathub).

2. Instale e execute o Zed:

   flatpak install flathub com.zed.Zed
   flatpak run com.zed.Zed

3. Para manter tudo atualizado: flatpak update com.zed.Zed. Caso não queira mais o editor: flatpak uninstall com.zed.Zed.

macOS

• Instale pelo Homebrew (recomendado para manter atualizações automáticas):

  brew install --cask zed

• Alternativa: baixe o .dmg oficial em zed.dev, arraste para Aplicativos e permita a execução em System Settings ▸ Privacy & Security caso apareça aviso do Gatekeeper.

Windows

• Instale via Winget:

  winget install Zed.Zed

• Ou baixe o instalador .exe em zed.dev/download e siga o wizard. Ao final, mantenha a opção Add Zed to PATH marcada para poder abrir o editor pelo terminal com zed ..

2. Instalando o Codex CLI (openai/codex)

O Codex CLI é distribuído como pacote npm, Homebrew cask e binário (tar/zip) em cada release. Abaixo estão os caminhos mais comuns em cada sistema operacional, todos baseados no README oficial do repositório.

Pré-requisitos gerais

• Assinatura plus do chat GPT.
• Node.js 18+ e npm para a instalação global (npm install -g).
• Homebrew caso opte pelo brew install --cask codex em macOS.
• Acesso ao GitHub Release para baixar binários stand-alone quando não quiser usar gerenciadores de pacotes.

Linux

# Instalação via npm (qualquer distro)
sudo npm install -g @openai/codex

# Verifique e inicie
codex --version
codex

macOS

# Opção 1: Homebrew (Apple Silicon e Intel)
brew install --cask codex

# Opção 2: npm global
sudo npm install -g @openai/codex

Windows (WSL 2) (Experimental)

# Instalação usando npm (PowerShell ou CMD)
npm install -g @openai/codex

# Depois de instalado
type codex --version
codex

Pós-instalação e login

1. Execute codex uma vez; ele perguntará se você quer Sign in with ChatGPT. Siga o fluxo no navegador e volte ao terminal quando o login confirmar.
2. Opcionalmente, configure servidores MCP e demais preferências no arquivo ~/.codex/config.toml conforme descrito em docs/config.md.
3. Para atualizar, use npm update -g @openai/codex ou brew upgrade codex. Em instalações manuais, substitua o binário existente pelo novo.

3. Atalho Alt+L para abrir o Codex no Zed

1. Abra o Zed e pressione Ctrl/Cmd+Shift+P ▸ digite zed: open keymap file.
2. Adicione a seguinte entrada ao arquivo keymap.json:

  {
	"context": "Workspace",
	"bindings": {
	  // Nova entrada adicionada
	  "alt+l": ["agent::NewExternalAgentThread", { "agent": "codex" }]
	}
  }

3. Salve o arquivo;

4. Meu settings.json

1. Abra o Zed e pressione Ctrl/Cmd+Shift+P ▸ digite zed: open settings file.

Pegue o que achar necessário:

{
  "telemetry": {
    "diagnostics": false,
    "metrics": false
  },
  "icon_theme": "VSCode Icons for Zed (Dark)",
  "ui_font_size": 15, // Diminui tamanho dos textos da UI do zed
  "unstable.ui_density": "compact", // Compacta mais a estrutura de pastas da UI 
  "ui_font_family": ".ZedMono",
  "indent_guides": {
    "line_width": 2
  },
  "tab_size": 2, // Define 2 espaços para tab
  "format_on_save": "off", // Tira auto save da aba
  "buffer_font_size": 14, // Diminui tamanho dos textos dos arquivos
  "theme": {
    "mode": "dark",
    "light": "Ayu Light",
    "dark": "Ayu Dark"
  }
}

5. Extensões Zed em uso

Lista de extensões que utilizo:

• HTML – suporte a HTML (realce, gramática e language server).
• PHP – suporte completo a PHP, incluindo debug adapters.
• Vue – suporte a Vue (gramática, linguagem e servidor de linguagem).
• SCSS – suporte a SCSS com syntax highlighting e language server.
• VSCode Icons – tema de ícones inspirado no conjunto do VS Code.
• Pug – suporte à sintaxe da linguagem Pug/Jade.

6. Como configurar alias para abrir o zed ( Bônus)

🟪 Alias para abrir o Zed (Bash)

Edite o arquivo .bashrc:

vi ~/.bashrc

Adicione:

alias zed="flatpak run dev.zed.Zed"

Recarregue o terminal do bash:

source ~/.bashrc

🟦 Alias para abrir o Zed (ZSH)

Edite o arquivo .zshrc:

vi ~/.zshrc

Adicione:

alias zed="flatpak run dev.zed.Zed"

Recarregue o terminal do bash:

source ~/.zshrc

🐟 Alias para abrir o Zed no (Fish)

Edite o arquivo config.fish:

vi ~/.config/fish/config.fish

Adicione:

alias zed="flatpak run dev.zed.Zed"

#or

function zed
    flatpak run dev.zed.Zed $argv
end

Recarregue o terminal do bash:

source ~/.config/fish/config.fish

🎉 Como usar o alias

Depois disso, você abre o Zed simplesmente com:

zed

# or

zed ~/projetos/meu-app

# or

zed .

REFERENCES

• https://github.com/openai/codex
• http://zed.dev/

RELATED NOTES