DeepSeek V4 Flash e Pro no Codex: Configuração e Seleção de Modelo
Configure o DeepSeek 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, então execute codex para conversar com o DeepSeek. Use deepseek-v4-flash, deepseek-v4-pro. O Codex conecta-se através da API Responses em https://apimaster.ai/v1.
Antes de começar
Complete 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 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 a partir do terminal:
mkdir -p ~/.codex
Abra ou crie o config.toml neste diretório. Se você usa um diretório de estado personalizado do Codex, use esse diretório.
2. Configure o config.toml
Ambas as plataformas usam o mesmo conteúdo:
model = "deepseek-v4-flash"
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 estas 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 provider se ela já existir. Isso altera o provider e o modelo padrão para novas sessões do Codex.
A URL base inclui /v1. Mantenha wire_api = "responses"; um endpoint de Chat Completions sozinho é 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 provider padrão existente, coloque esta configuração em ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Em seguida, adicione --profile deepseek aos comandos de inicialização abaixo. Arquivos de perfil nomeados requerem o Codex 0.134.0 ou posterior e herdam as outras configurações de base.
3. Defina sua chave de API
Substitua YOUR_APIMASTER_API_KEY pela chave obtida na 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 vale para o terminal atual. Para reutilizá-la em novos terminais, adicione a mesma linha de export ao arquivo de inicialização do seu shell, como ~/.zshrc para Zsh ou ~/.bashrc para Bash interativo, e então abra um novo terminal. Mantenha arquivos contendo 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 é deepseek-v4-flash. Na conversa do Codex, digite:
Reply with exactly OK.
Uma resposta normal confirma a conexão básica. Você pode então 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 deepseek-v4-flash
codex --model deepseek-v4-pro
Cada comando abre uma conversa interativa. Para sair de uma sessão aberta, digite /exit e 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 DeepSeek não estiver presente, use --model como acima. Não presuma que a sintaxe /model MODEL_ID do Claude Code funciona no Codex; este não é o caminho verificado de seleção de modelo personalizado aqui.
Para o perfil nomeado opcional, por exemplo:
codex --profile deepseek --model deepseek-v4-flash
Para alterar o padrão para inicializações futuras, edite o valor de nível superior model 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 provider | Verifique model_provider, o perfil selecionado, overrides do projeto e flags de inicialização. Reinicie após editar a configuração. |
| Erro de parsing 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 do /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 stream 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, o horário UTC e o ID da requisição, se disponível. |
Validação e verificação opcional de ferramentas
Testes de integração registrados: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. Todos os modelos listados aqui retornaram o texto esperado e usaram uma ferramenta para ler um arquivo local. Tarefas complexas de codificação ficaram fora do escopo desse teste. 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 total de recursos, comportamento em sessões longas ou limites máximos de contexto.
Para verificar as ferramentas de arquivo, crie um probe.txt em um projeto temporário contendo:
FILE_PROBE_739182
Inicie o Codex nesse diretório com o modelo escolhido e digite:
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 funcionar.
FAQ
Isso usa minha assinatura do ChatGPT?
As requisições usam sua chave e saldo da APIMaster. O Codex é o cliente; o DeepSeek é o modelo selecionado. Esta configuração não torna o DeepSeek 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 anexa /v1/messages ele próprio.