---
title: "Integração do Codex CLI"
description: "Método de configuração para integrar o OpenAI Codex CLI com a 1折AI (model_providers em ~/.codex/config.toml), chamando modelos GPT por meio da Responses API."
headingIds: {"Arquivo de Configuração":"section-1","Instalando o Codex":"section-2","Perguntas Frequentes":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Os modelos OpenAI / GPT já estão ativos. O Codex CLI usa a OpenAI Responses API (`/v1/responses`) e se conecta usando a chave de API deste site. Para ver os modelos disponíveis e os preços, consulte o [catálogo de modelos](https://1zheai.com/model-catalog).

Primeiro, vamos esclarecer como configurar um provedor personalizado para o Codex. O formato vem da [documentação oficial de configuração do Codex](https://developers.openai.com/codex/config-reference).

## Arquivo de Configuração

A configuração do Codex fica em `~/.codex/config.toml`. Provedores personalizados só podem ser escritos neste arquivo de nível de usuário; a configuração `.codex/config.toml` `model_provider` em um projeto será ignorada.

```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"

[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```

O exemplo usa `gpt-6-astra`, que pode ser substituído por qualquer outro ID de modelo GPT suportado pela sua chave.

Significado de cada campo:

| Campo | Descrição |
|---|---|
| `model_provider` | Qual provedor usar, correspondente ao id em `[model_providers.<id>]` abaixo. `openai`, `ollama`, `lmstudio` são nomes reservados e não podem ser usados |
| `base_url` | Deve incluir `/v1` |
| `env_key` | O Codex lê a chave de API desta variável de ambiente; o nome deve corresponder exatamente ao que você exporta |
| `wire_api` | A documentação oficial afirma que atualmente apenas `responses` é suportado; também é o padrão quando omitido |

Em seguida, coloque a chave de API em uma variável de ambiente:

<CodeGroup>
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
</CodeGroup>

## Instalando o Codex

Os comandos a seguir vêm da documentação oficial do Codex:

<CodeGroup>
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
</CodeGroup>

## Perguntas Frequentes

<AccordionGroup>
<Accordion title="401？">

O nome da variável em `env_key` não corresponde ao que você realmente exportou, ou você abriu o terminal antes de definir a variável de ambiente. Verifique novamente os nomes em ambos os lados e, em seguida, reabra o terminal e tente novamente.

</Accordion>
<Accordion title="Dá para mudar wire_api para chat?">

Não. A documentação oficial de configuração do Codex afirma que `wire_api` aceita apenas `responses`. Serviços que fornecem apenas uma API Chat Completions precisam de uma ferramenta adicional de conversão de protocolo para se conectar ao Codex.

</Accordion>
<Accordion title="Como escolher o modelo GPT?">

Verifique os modelos atuais no [catálogo de modelos](https://1zheai.com/model-catalog) e preencha o ID do modelo em `model`. Após iniciar o Codex, faça uma solicitação curta e verifique o modelo e o status no [log de chamadas](/pt/docs/usage-logs/).

</Accordion>
</AccordionGroup>