Facade CodeCodex + 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.
1. Defina o provedor
Adicione esta configuração ao facade.json (veja Configurações dos agentes). Substitua a URL base, a chave e o ID de modelo do exemplo:
{
"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.
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.
Use um perfil do Codex existente
Se você já usa um perfil nativo do Codex, selecione-o pelos argumentos da entrada:
{
"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.