> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensão Codex para VS Code

> Reuse a configuração do Codex CLI com 4096bytes no VS Code

A extensão Codex para VS Code pode reutilizar a configuração local do Codex CLI. Configure `config.toml` e `auth.json` primeiro, depois instale a extensão Codex no VS Code.

Se você já concluiu a configuração de [Codex](/pt-BR/clients/codex), instale a extensão e reinicie o VS Code. Não é necessário criar outra API Key.

## Pré-requisitos

* Você concluiu [Criar conta](/pt-BR/quickstart/create-account).
* Você concluiu [Obter API Key](/pt-BR/quickstart/get-api-key).
* O VS Code está instalado.
* Você concluiu a configuração do Codex CLI na página [Codex](/pt-BR/clients/codex).
* A janela **Use key** está aberta para a API Key que você quer usar.

<Warning>
  A API Key em `auth.json` fica salva localmente em texto simples. Não envie `~/.codex/auth.json`, capturas de tela ou saída do terminal para repositórios ou conversas.
</Warning>

## Instalar a configuração do Codex CLI

Conclua primeiro a [configuração do Codex CLI](/pt-BR/clients/codex). Essa etapa grava os valores de conexão do 4096bytes no diretório local de configuração do Codex.

| Sistema       | `config.toml`                      | `auth.json`                      |
| ------------- | ---------------------------------- | -------------------------------- |
| macOS / Linux | `~/.codex/config.toml`             | `~/.codex/auth.json`             |
| Windows       | `%USERPROFILE%\.codex\config.toml` | `%USERPROFILE%\.codex\auth.json` |

Use os valores de `model`, `review_model`, `base_url` e API Key exibidos no painel. Veja a página [Codex](/pt-BR/clients/codex) para entender cada campo.

Se você usa VS Code Remote - WSL, grave a configuração no diretório `~/.codex/` do WSL.

## Instalar a extensão do VS Code

<Steps>
  <Step title="Abrir Extensions">
    Abra o painel **Extensions** no VS Code.
  </Step>

  <Step title="Instalar a extensão Codex">
    Pesquise pela extensão Codex publicada pela OpenAI e clique em **Install**.
  </Step>

  <Step title="Reiniciar o VS Code">
    Depois da instalação, feche todas as janelas do VS Code e reabra o projeto.
  </Step>

  <Step title="Usar Codex">
    Abra a entrada Codex no VS Code. A extensão lê a configuração local do Codex.
  </Step>
</Steps>

## Verificar

Abra um projeto local e envie uma tarefa de baixo risco na extensão Codex:

```text theme={null}
Descreva em uma frase a finalidade do projeto atual. Não modifique arquivos.
```

Se a extensão responder sem erro de autenticação ou de modelo, a configuração está ativa.

## Problemas comuns

<AccordionGroup>
  <Accordion title="Já configurei o Codex CLI. Preciso repetir?">
    Não. A extensão Codex para VS Code lê a mesma configuração em `~/.codex/`. Instale a extensão e reinicie o VS Code.
  </Accordion>

  <Accordion title="A extensão ainda usa o modelo ou endereço antigo">
    Coloque a nova configuração no início de `config.toml`. Salve, feche todas as janelas do VS Code e reabra o projeto.
  </Accordion>

  <Accordion title="A extensão mostra falha de autenticação">
    Verifique se `auth.json` é JSON válido. Confirme que a API Key não tem caracteres faltando, quebras de linha ou espaços extras.
  </Accordion>

  <Accordion title="Remote - WSL não usa a configuração">
    Se o projeto roda no WSL, configure `~/.codex/` do WSL, não apenas `%USERPROFILE%\.codex\` no Windows.
  </Accordion>
</AccordionGroup>