Codex: Codex com DeepSeek

Última atualização: 2026-08-31

O DeepSeek é um grande modelo de linguagem líder com excelente desempenho em geração de código. Esta lição aborda como usar modelos DeepSeek dentro do Codex.

📋 Pré-requisitos: Codex CLI instalado, conhecimento básico de configuração de API Key

1. O Que Você Vai Aprender

• Por que usar DeepSeek com o Codex
• Método de integração oficial
• Configuração da ferramenta de terceiros CCSwitch
• Comparação entre DeepSeek e modelos OpenAI

2. Por Que Usar DeepSeek

(1) Comparação de Preços

3. Método de Integração Oficial

O Codex CLI suporta o DeepSeek via API compatível com OpenAI.

(1) Obter uma API Key do DeepSeek

1. Visite platform.deepseek.com
2. Registre-se / faça login
3. Vá para a página de API Keys
4. Crie uma nova API Key
5. Copie e salve (exibida apenas uma vez)

(2) Configurar Variáveis de Ambiente

# macOS/Linux
export OPENAI_API_KEY="sk-your-deepseek-key"
export OPENAI_BASE_URL="https://api.deepseek.com"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-deepseek-key"
$env:OPENAI_BASE_URL="https://api.deepseek.com"

# Permanente (adicione ao ~/.zshrc ou ~/.bashrc)
echo 'export OPENAI_API_KEY="sk-your-deepseek-key"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.deepseek.com"' >> ~/.zshrc
source ~/.zshrc

(3) Iniciar o Codex

# Iniciar com modelo DeepSeek
codex --model deepseek-coder

# Ou usar DeepSeek V3
codex --model deepseek-chat

▶ Exemplo 1: Alice Muda para DeepSeek

# Alice quer economizar custos, muda para DeepSeek
export OPENAI_API_KEY="sk-deepseek-xxx"
export OPENAI_BASE_URL="https://api.deepseek.com"

cd my-project
codex --model deepseek-coder

# Alice digita:
> "Add OAuth2 support to the auth module"

# DeepSeek Coder executa a tarefa normalmente

4. Ferramenta CCSwitch

O CCSwitch é uma ferramenta de terceiros desenvolvida pela comunidade para alternar rapidamente entre diferentes provedores de modelos.

(1) Instalar CCSwitch

npm install -g ccswitch

(2) Configurar Provedores de Modelo

# Adicionar config do DeepSeek
ccswitch add deepseek \
  --api-key "sk-your-deepseek-key" \
  --base-url "https://api.deepseek.com" \
  --model "deepseek-coder"

# Adicionar config da OpenAI
ccswitch add openai \
  --api-key "sk-your-openai-key" \
  --base-url "https://api.openai.com/v1" \
  --model "gpt-5-codex"

(3) Alternância Rápida

# Mudar para DeepSeek
ccswitch use deepseek

# Mudar para OpenAI
ccswitch use openai

# Ver config atual
ccswitch current

▶ Exemplo 2: Fluxo de Trabalho Multi-Modelo de Bob

# Dev diário com DeepSeek (economia)
ccswitch use deepseek
codex "Fix the CSS issue on the login page"

# Tarefas de arquitetura complexa com OpenAI (mais capaz)
ccswitch use openai
codex "Design a microservice decomposition plan, generate architecture docs"

# Revisão de código com DeepSeek Coder
ccswitch use deepseek
codex "Review the code quality of PR #15"

5. Comparação DeepSeek vs OpenAI

6. Configuração auth.json

Você também pode gerenciar múltiplas API Keys via arquivo de configuração:

{
  "OPENAI_API_KEY": "sk-your-deepseek-key",
  "OPENAI_BASE_URL": "https://api.deepseek.com",
  "model": "deepseek-coder"
}

# Escrever config
mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-deepseek-xxx",
  "OPENAI_BASE_URL": "https://api.deepseek.com"
}
EOF

7. Notas Importantes

❓ Perguntas Frequentes

P: O DeepSeek pode substituir totalmente os modelos OpenAI? R: Para tarefas de desenvolvimento diário, na maioria dos casos sim. Mas para raciocínio arquitetural complexo e refatoração global multi-arquivo, os modelos OpenAI ainda são mais fortes. Escolha com base na complexidade da tarefa.

P: O CCSwitch é seguro? R: O CCSwitch é uma ferramenta de comunidade open-source; API Keys são armazenadas em arquivos de config locais. Revise o código-fonte para confirmar a segurança.

P: Posso usar ambos os modelos simultaneamente? R: Não na mesma sessão. Você precisa encerrar a sessão atual, trocar a configuração e reiniciar.

P: A janela de contexto do DeepSeek é grande o suficiente? R: DeepSeek V3 suporta 128K de contexto, comparável aos modelos OpenAI — suficiente para a maioria dos projetos.

P: O Codex se comporta diferente após trocar de modelo? R: Operações básicas permanecem as mesmas, mas diferentes modelos têm diferentes capacidades de raciocínio e estilos de saída. DeepSeek tem melhor compreensão em chinês; OpenAI tem raciocínio complexo mais forte.

📖 Resumo

• Conecte o DeepSeek via variável de ambiente OPENAI_BASE_URL
• CCSwitch permite alternância rápida entre múltiplos modelos
• DeepSeek: custo menor, melhor em chinês — ideal para desenvolvimento diário
• Tarefas de arquitetura complexa ainda se beneficiam dos modelos OpenAI
• Trocar de modelo requer reiniciar a sessão do Codex

📝 Exercícios

1. Básico (⭐): Configure a API DeepSeek e a use com sucesso no Codex CLI.
2. Intermediário (⭐⭐): Configure dois provedores de modelo com o CCSwitch e compare seu desempenho na mesma tarefa.
3. Avançado (⭐⭐⭐): Desenhe uma estratégia de troca automática — tarefas simples usam DeepSeek, tarefas complexas usam OpenAI — e escreva um script de alternância.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós