OpenCode: OpenCode API Setup and DeepSeek
Última atualização: 2026-08-31
--- title: Configuração de API do OpenCode e DeepSeek description: Aprenda a configurar as chaves API do OpenCode, conectando-se a serviços como OpenCode Zen, DeepSeek e Alibaba Bailian order: 3 lang: pt-br
O OpenCode não inclui modelos de IA — é necessário configurar uma API Key para se conectar a serviços de LLM.
1. O Que Você Vai Aprender
- Modo gratuito OpenCode Zen
- Fluxo de configuração de API Key
- Como conectar ao DeepSeek
- Configuração de APIs
- Ferramenta de gestão CC Switch
2. OpenCode Zen (Recomendado para Iniciantes)
OpenCode Zen é um conjunto de modelos selecionados oficialmente, testados e otimizados, prontos para uso. Inclui muitos modelos gratuitos.
(1) Passos de Configuração
No terminal:
opencode
No TUI do OpenCode:
/connect
Selecione opencode e siga as instruções para obter a API Key.
(2) Obter API Key
Acesse https://opencode.ai/auth, faça login e crie uma API Key.
(3) Colar API Key
Volte ao terminal e cole a API Key obtida.
(4) Ver Modelos Disponíveis
/model
Modelos marcados com Free podem ser usados gratuitamente.
3. Conectando ao DeepSeek
DeepSeek é um LLM chinês com excelente custo-benefício.
(1) Obter API Key
Acesse https://platform.deepseek.com/api_keys, registre-se e crie uma API Key.
Modelos oficiais DeepSeek:
| Modelo | Descrição |
|---|---|
| deepseek-v4-flash | Versão rápida |
| deepseek-v4-pro | Versão profissional |
(2) Configurar no OpenCode
No TUI digite /connect, selecione DeepSeek, cole a API Key.
(3) Selecionar Modelo
/model
Selecione o modelo DeepSeek correspondente.
4. Conectando ao Alibaba Bailian
(1) Obter API Key
Acesse o console Alibaba Cloud Bailian em https://bailian.console.aliyun.com/, faça login, clique no ícone de engrenagem → API Key → Copiar ou criar.
(2) Configurar no OpenCode
/connect
Digite alibaba na busca, selecione Alibaba (China), cole a API Key.
5. CC Switch — Ferramenta de Gestão
CC Switch gerencia configurações de API para Claude Code / Codex / OpenCode.
- GitHub: https://github.com/farion1231/cc-switch/
- Suporta Windows / macOS / Linux
Passos: Abrir CC Switch → Selecionar OpenCode → Adicionar provedor → Inserir API Key → Definir modelo.
Teste no terminal:
opencode run Explique o princípio de closures em JavaScript
❓ FAQ
P: Os modelos gratuitos do OpenCode Zen são suficientes?
R: Para aprendizado e desenvolvimento leve, sim. Para capacidades de geração de código mais avançadas, recomendamos conectar a modelos pagos como DeepSeek-v4-pro ou Claude Sonnet.
P: Posso configurar múltiplas API Keys simultaneamente?
R: Sim. Use
/connectpara adicionar múltiplos provedores e/modelpara alternar entre eles.
P: API Keys são armazenadas com segurança?
R: São armazenadas localmente em
~/.local/share/opencode/auth.jsone não são enviadas para a nuvem. Recomendamos rotacionar as API Keys periodicamente.
📖 Resumo
- Iniciantes: OpenCode Zen com modelos gratuitos, pronto para usar
- DeepSeek: excelente custo-benefício
- Alibaba Bailian: múltiplos modelos, ideal para alternância flexível
- CC Switch: gestão unificada de múltiplas configurações de API
- API Keys são armazenadas localmente — mantenha-as seguras
📝 Exercícios
-
Básico: Configure OpenCode Zen ou DeepSeek API Key e inicie o OpenCode com sucesso.
-
Intermediário: Configure dois provedores de API simultaneamente e alterne entre eles.
-
Avançado: Use o CC Switch para gerenciar suas APIs e complete uma chamada não-interativa via linha de comando.