# Codex + seu provedor

Dê a uma configuração de inicialização do Codex seu próprio provedor de modelos ou use um perfil nativo que você já tenha.

## Obtenha os dados do provedor

Instale o Codex e obtenha a URL base, a chave de API e o ID de modelo do seu provedor. O endpoint precisa oferecer suporte à API Responses da OpenAI; compatibilidade com Chat Completions não basta.

O exemplo adiciona `Codex · work` sem alterar outras entradas do Codex nem editar a configuração global do Codex.

Já tem um perfil do Codex? Pule para [Use um perfil do Codex existente](https://facadecode.com/pt-br/docs/providers/codex/#profile).

## 1. Defina o provedor

Adicione esta configuração ao facade.json (veja [Configurações dos agentes](https://facadecode.com/pt-br/docs/settings/)). Substitua a URL base, a chave e o ID de modelo do exemplo:

```json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Use o mesmo ID de provedor, `work`, em `model_provider=work` e em todas as configurações `model_providers.work.…`. O nome da variável da chave, `WORK_API_KEY`, precisa corresponder a `env_key`.

## 2. Confira as configurações do provedor

| Configuração | O que faz |
| --- | --- |
| `model_provider=work` | Seleciona o provedor definido nas configurações de work. |
| `model_providers.work.name` | Dá um nome de exibição a esse provedor. |
| `model_providers.work.base_url` | Define a URL base da API. |
| `model_providers.work.wire_api=responses` | Usa o formato da API Responses. |
| `model_providers.work.env_key=WORK_API_KEY` | Informa ao Codex qual variável de ambiente contém a chave. |
| `env.WORK_API_KEY` | Fornece essa chave ao processo do Codex. |

Cada `-c` define uma opção do Codex para agentes iniciados com esta entrada.

O exemplo armazena a chave no facade.json. Se a chave já estiver em uma variável de ambiente, defina `env.WORK_API_KEY` como `${env:WORK_API_KEY}`. O editor precisa ter essa variável antes de o agente iniciar.

## 3. Inicie o Codex com esta configuração

Salve o facade.json, escolha **New Agent** e selecione `Codex · work`. Use `/model` para checar o modelo selecionado e envie uma tarefa curta para o seu projeto.

Se seu provedor mostra dados de uso, confirme que a solicitação aparece na conta certa. Para checar a configuração de inicialização, execute **Show Agent Launch** e escolha o local de trabalho. Encontre esta entrada no relatório para ver como o próximo agente iniciaria com suas configurações atuais.

Para erros de solicitação, veja [Solução de problemas](https://facadecode.com/pt-br/docs/troubleshooting/).

## Exemplo: QwenCloud

Para uma chave do plano Token do QwenCloud, use `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1` como URL base e mantenha `wire_api=responses`. Use um modelo disponível no seu plano. Chaves de pagamento por uso usam o endpoint da região delas.

[Configurações atuais do QwenCloud para Codex ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

## Use um perfil do Codex existente

Se você já usa um perfil nativo do Codex, selecione-o pelos argumentos da entrada:

```json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}
```

Substitua `work` pelo perfil que você usa. Mantenha a configuração do provedor nesse perfil em vez de repeti-la na entrada do Facade. Salve, escolha **New Agent** e selecione `Codex · profile`. Envie uma tarefa curta e confirme a solicitação nos registros de uso do seu provedor, quando disponíveis.