Usando DeepSeek no Codex CLI: Guia de Configuração V4 Flash / Pro

Configure DeepSeek V4 Flash e Pro no Codex CLI através do endpoint Responses da APIMaster. Inclui configuração de chave de API, alternância de modelos, testes de ferramentas e solução de problemas.

O Codex CLI pode usar DeepSeek? Nossos testes com Codex CLI 0.153.4 usaram com sucesso deepseek-v4-flash e deepseek-v4-pro através do endpoint Responses da APIMaster. Configure um provedor personalizado com URL base https://apimaster.ai/v1 e wire_api = "responses". Apenas Chat Completions compatível com OpenAI não é suficiente para esta configuração.

Último teste: 2026-09-07, Codex CLI 0.153.4, Linux. Ambos os modelos retornaram o texto esperado, invocaram uma ferramenta de shell para ler um arquivo de teste local e responderam com seu conteúdo. Todas as execuções terminaram com código 0. Ocorreram avisos de metadados e eventos de streaming; consulte a solução de problemas. Comandos para Windows / macOS são fornecidos para configuração, mas este teste foi executado no Linux. Sessões longas, entrada de imagem e fluxos de trabalho complexos de codificação não foram testados.

1. Prepare o Codex e sua chave de API

Instale o Codex seguindo o guia de ambiente e o guia de configuração do Codex, depois verifique:

codex --version

Crie uma chave de API APIMaster com acesso ao modelo DeepSeek selecionado e cota suficiente. Para este tutorial, use a configuração dedicada abaixo; você não precisa substituir um auth.json existente ou sair de outra conta.

2. Defina a chave no seu terminal

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

A variável existe apenas nesta sessão de terminal. A configuração armazena o nome da variável, não o segredo em si.

3. Crie uma configuração de provedor separada

Em um diretório que você usa para este tutorial, crie deepseek.toml com este conteúdo. Mantenha sua configuração existente do Codex inalterada.

model = "deepseek-v4-flash"
model_provider = "apimaster_deepseek"

[model_providers.apimaster_deepseek]
name = "APIMaster DeepSeek"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"

Para um primeiro teste copiável e isolado, passe as mesmas configurações como substituições de linha de comando. --ignore-user-config impede que outro provedor em sua configuração normal tenha precedência. --ephemeral evita salvar esta sessão de teste.

codex exec --ignore-user-config --ephemeral --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash -c 'model_provider="apimaster_deepseek"' -c 'model_providers.apimaster_deepseek.name="APIMaster DeepSeek"' -c 'model_providers.apimaster_deepseek.base_url="https://apimaster.ai/v1"' -c 'model_providers.apimaster_deepseek.env_key="APIMASTER_API_KEY"' -c 'model_providers.apimaster_deepseek.wire_api="responses"' "Reply with exactly: DEEPSEEK_TEST_OK"

Execute o comando no terminal onde você definiu a chave. Resposta final esperada: DEEPSEEK_TEST_OK. Em versões mais antigas do Windows PowerShell, a citação de argumentos nativos pode diferir; use PowerShell 7 ou o método de perfil abaixo se os argumentos TOML forem rejeitados.

4. Salve a configuração como um perfil reutilizável

Para a versão testada do CLI, coloque deepseek.toml em ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Se CODEX_HOME for personalizado, use esse diretório em vez disso. Este perfil nomeado mantém as configurações do DeepSeek separadas do seu config.toml normal.

macOS / Linux, a partir do diretório que contém deepseek.toml:

mkdir -p ~/.codex
cp deepseek.toml ~/.codex/deepseek.config.toml
codex --profile deepseek --model deepseek-v4-flash

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
Copy-Item .\deepseek.toml "$env:USERPROFILE\.codex\deepseek.config.toml"
codex --profile deepseek --model deepseek-v4-flash

Faça backup de um arquivo de perfil primeiro se esse nome de arquivo já existir. A sintaxe do perfil depende da versão: esses comandos visam 0.153.4. Verifique codex --help na sua versão instalada; versões mais antigas podem usar perfis dentro de config.toml em vez disso.

Para usar Pro:

codex --profile deepseek --model deepseek-v4-pro

Um perfil é sobreposto à sua configuração normal, então servidores MCP existentes ou outras configurações ainda podem ser aplicados. O comando isolado na etapa 3 é útil ao diagnosticar conflitos de configuração.

5. Verifique uma chamada de ferramenta

Crie um arquivo local chamado probe.txt contendo:

TOOL_PROBE_739182

Do mesmo diretório, execute:

codex exec --profile deepseek --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash "Use your file reading or shell tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Esperado: um comando de leitura de arquivo é executado com sucesso, seguido por TOOL_PROBE_739182. Repita com --model deepseek-v4-pro. Isso verifica um ciclo de ida e volta de solicitação de ferramenta / resultado de ferramenta, além de uma simples resposta de texto. Mantenha os prompts de permissão normais habilitados para trabalho real de projeto.

Solução de problemas

Sintoma	Explicação ou próximo passo
`Model metadata ... not found`	O CLI testado não tinha metadados integrados para esses IDs de modelo e usou metadados de fallback. Nossos testes de texto e ferramenta foram concluídos, mas limites de contexto e outros padrões não devem ser tratados como capacidades verificadas do modelo.
Erro de análise da lista de modelos	A lista de modelos do gateway pode diferir do catálogo de metadados do Codex. Especifique o modelo explicitamente e verifique se a solicitação real termina.
`OutputTextDelta without active item`	Visto em nosso teste de streaming. A resposta final e o ciclo de ferramenta ainda foram concluídos. Se a saída estiver ausente ou interrompida, preserve a versão do CLI, timestamp e erro para suporte.
401 ou solicitação vai para outro provedor	Verifique `APIMASTER_API_KEY`, seleção de provedor e configurações herdadas. Repita o comando isolado na etapa 3.
404 ou protocolo não suportado	A URL base termina em `/v1`, não `/chat/completions`; defina `wire_api = "responses"`.
Opção de linha de comando desconhecida	Verifique a versão instalada do CLI. As opções documentadas foram testadas com 0.153.4.

Perguntas frequentes

Isso significa que todo endpoint DeepSeek funciona no Codex?

Não. Esses resultados se aplicam à configuração de gateway da APIMaster. Um provedor deve suportar o protocolo e o comportamento de ferramenta que o Codex espera; aceitar /chat/completions não estabelece compatibilidade com Responses.

Preciso de uma assinatura ChatGPT para esta configuração?

Este provedor personalizado usa sua chave de API APIMaster e cota da conta. Não usa cota de assinatura ChatGPT. Verifique o marketplace de modelos para taxas de API atuais.

Posso reivindicar compatibilidade total com Codex a partir desses testes?

O escopo verificado é saída de texto curto e um ciclo de ferramenta de leitura de arquivo local. Os avisos acima permanecem relevantes; comportamento de contexto longo, todas as ferramentas e cada versão futura do CLI não são cobertos.