Configuração do Codex CLI
O Codex CLI é o Codex no terminal. É ideal para permitir que o Codex leia código, modifique arquivos, execute testes e explique erros em projetos locais. As configurações do aplicativo desktop estão na página do cliente Codex; esta seção aborda especificamente a CLI no terminal.
O que é esta ferramenta e para que serve
Localização do arquivo de configuração
| Sistema | Caminho de exemplo | Descrição |
|---|---|---|
| Windows | C: \Users\YourUsername\. codex\config.toml | Altere o nome de usuário para o do seu próprio computador |
| macOS / Linux | ~/. codex/config.toml | Se o arquivo não existir, crie um novo config.toml |
Como configurar um provedor personalizado
Se você estiver usando apenas a conta oficial, siga primeiro o processo de login oficial. Adicione um provedor personalizado apenas quando o provedor oferecer explicitamente configurações compatíveis com Codex / OpenAI.
codex login codex "Please reply only: Configuration successful"model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| Configuração | Como preencher | Atenção |
|---|---|---|
| model | ID do modelo / Nome do modelo na lista de modelos do painel do provedor | Não preencha com um nome de exibição inventado por você e não altere maiúsculas/minúsculas, hifens ou pontos |
| model_provider | O nome do provedor abaixo | Deve ser consistente com o xxx em [model_providers.xxx] |
| base_url | Endereço da API fornecido pelo painel do provedor | Decida se deve incluir /v1 de acordo com o exemplo do painel |
| env_key | Nome da variável de ambiente local | Escreva o nome da variável aqui, não insira a chave diretamente |
| wire_api | Protocolo de interface | Selecione de acordo com a documentação oficial do Codex e as instruções do provedor |
Chave e testes
O env_key acima é apenas o nome da variável; a chave real deve ser inserida na variável de ambiente local. Configure-a temporariamente primeiro para teste e, após confirmar o funcionamento, considere salvá-la de forma definitiva.
$env:MZ_PROXY_API_KEY = "YOUR_KEY" codex "Please reply only: Configuration successful"MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"No TOML, posicione model e model_provider no início do arquivo; não os adicione dentro da seção [model_providers.xxx].