GLM-5.2, GLM-5.3 e GLM-5.3-Flash no Codex: Configuração e Seleção de Modelo
Configure o GLM no Codex com a APIMaster. Encontre o config.toml no Windows, macOS e Linux, defina sua chave de API, inicie um chat interativo e selecione um modelo.
Configure sua chave de API da APIMaster e o config.toml do Codex e, em seguida, execute codex para conversar com o GLM. Use glm-5.2, glm-5.3, glm-5.3-flash. O Codex se conecta por meio da API Responses em https://apimaster.ai/v1.
Antes de começar
Conclua a verificação do ambiente, instale o Codex seguindo o guia geral e obtenha uma chave de API da APIMaster com acesso a esses modelos e saldo suficiente.
codex --version
1. Abra o diretório de configuração
Windows
Pressione Win + R, insira o caminho a seguir e pressione Enter:
%USERPROFILE%\.codex
Crie a pasta se ela não existir. Abra ou crie o arquivo config.toml com um editor de texto. Certifique-se de que o nome do arquivo não seja config.toml.txt.
macOS / Linux
No macOS, no Finder, pressione Command + Shift + G e insira:
~/.codex
No Linux, abra o mesmo diretório com seu gerenciador de arquivos ou editor. Se necessário, crie-o pelo terminal:
mkdir -p ~/.codex
Abra ou crie o arquivo config.toml nesse diretório. Se você usa um diretório de estado personalizado do Codex, use esse diretório em vez deste.
2. Configure o config.toml
Ambas as plataformas usam o mesmo conteúdo:
model = "glm-5.3"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Se o arquivo já existir, faça um backup e mescle essas configurações. Substitua as chaves de nível superior existentes em vez de duplicá-las, e coloque-as antes do primeiro cabeçalho [tabela]. Mescle a seção do provedor se ela já existir. Isso altera o provedor e o modelo padrão para novas sessões do Codex.
A URL base inclui /v1. Mantenha wire_api = "responses"; um endpoint somente de Chat Completions é insuficiente para este fluxo de trabalho. As configurações de resumo desativam os resumos de raciocínio opcionais, não o pensamento interno do modelo.
Para manter seu provedor padrão existente, coloque esta configuração em ~/.codex/glm.config.toml (Windows: %USERPROFILE%\.codex\glm.config.toml). Em seguida, adicione --profile glm aos comandos de inicialização abaixo. Arquivos de perfil nomeados exigem o Codex 0.134.0 ou posterior e herdam as outras configurações básicas.
3. Defina sua chave de API
Substitua YOUR_APIMASTER_API_KEY pela chave da APIMaster. A configuração TOML armazena o nome da variável de ambiente, não a chave em si.
Windows PowerShell
Execute no terminal onde você iniciará o Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Para também salvá-la para terminais futuros:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
Abra um novo terminal após salvar uma variável persistente, ou continue usando o terminal atual onde você executou o primeiro comando.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Isso se aplica ao terminal atual. Para reutilizá-la em novos terminais, adicione a mesma linha de exportação ao arquivo de inicialização do seu shell, como ~/.zshrc para Zsh ou ~/.bashrc para Bash interativo, e depois abra um novo terminal. Mantenha os arquivos que contêm chaves reais privados e fora de repositórios compartilhados.
4. Inicie o Codex e converse
Abra um terminal no diretório do seu projeto e execute:
codex
Após os prompts normais de primeira execução ou de confiança no projeto, verifique se o modelo ativo é glm-5.3. Na conversa do Codex, insira:
Reply with exactly OK.
Uma resposta normal confirma a conexão básica. Em seguida, você pode pedir para ele explicar código, ler um arquivo ou fazer uma alteração. Revise os prompts habituais de permissão de arquivos e comandos.
5. Selecione outro modelo
Para esses IDs de modelo personalizados, escolha o modelo explicitamente ao iniciar o Codex. Execute um comando por vez no seu terminal:
codex --model glm-5.2
codex --model glm-5.3
codex --model glm-5.3-flash
Cada comando abre uma conversa interativa. Para alternar a partir de uma sessão aberta, insira /exit e, em seguida, execute o comando do modelo desejado. Para continuar uma conversa salva existente com outro modelo, use codex resume SESSION_ID --model MODEL_ID em vez de iniciar uma nova conversa.
No Codex, /model abre o catálogo de modelos e /status mostra o modelo ativo. O menu não lista automaticamente todos os modelos do marketplace de modelos da APIMaster. Se o seu modelo GLM estiver ausente, use --model como acima. Não presuma que a sintaxe /model MODEL_ID do Claude Code funciona no Codex; não é esse o caminho verificado de seleção de modelos personalizados aqui.
Para o perfil nomeado opcional, por exemplo:
codex --profile glm --model glm-5.3
Para alterar o padrão para inicializações futuras, edite o valor de model de nível superior na configuração que você usa.
Solução de problemas
| Sintoma | Verificação |
|---|---|
| Chave de API ausente / 401 | Defina APIMASTER_API_KEY no terminal que inicia o Codex; verifique a validade da chave e o saldo. |
| Ainda usando outro provedor | Verifique model_provider, o perfil selecionado, substituições do projeto e flags de inicialização. Reinicie após editar a configuração. |
| Erro de análise do TOML | Evite chaves ou tabelas duplicadas; as configurações de nível superior devem preceder os cabeçalhos de tabela. |
| 404 / protocolo não suportado | Use https://apimaster.ai/v1 e wire_api = "responses". |
| Modelo ausente no /model | Use o ID completo do modelo com codex --model. O catálogo integrado não é a lista de modelos do gateway. |
| Aviso de metadados do modelo ou da lista de modelos | Esses IDs podem não ter metadados no Codex. Verifique a resposta final; limites de contexto de fallback não são capacidades verificadas do modelo. |
| Aviso de fluxo de raciocínio/saída | Verifique a resposta final e os resultados das ferramentas. Relate saída interrompida com o modelo, a versão da CLI, a hora UTC e o ID da requisição, se disponível. |
Validação e verificação opcional de ferramentas
Testes de integração registrados: 15/09/2026 UTC, Codex CLI 0.154.0, Linux. Todos os modelos listados aqui retornaram o texto esperado e usaram uma ferramenta para ler um arquivo local. Todos os três também corrigiram uma pequena função Python e executaram seus testes; o arquivo de teste foi verificado e executado novamente de forma independente. Instruções de configuração para Windows e macOS são fornecidas, mas esses sistemas operacionais não fizeram parte das execuções registradas. Essas verificações não estabelecem compatibilidade completa de recursos, comportamento em sessões longas nem limites máximos de contexto.
Para verificar as ferramentas de arquivo, crie probe.txt em um projeto temporário contendo:
FILE_PROBE_739182
Inicie o Codex nesse local com o modelo escolhido e, em seguida, insira:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Confirme que uma ferramenta de leitura de arquivo é executada e a resposta corresponde ao arquivo. Use isto depois que a conversa básica estiver funcionando.
FAQ
Isso usa minha assinatura do ChatGPT?
As requisições usam sua chave e saldo da APIMaster. O Codex é o cliente; o GLM é o modelo selecionado. Esta configuração não torna o GLM um modelo da OpenAI.
Por que o Claude Code usa uma URL diferente?
O Codex usa https://apimaster.ai/v1 para Responses. O Claude Code usa a raiz do site https://apimaster.ai e acrescenta /v1/messages ele próprio.