DeepSeek V4.1 no Windows: OpenCode, Kimi e Hermes
Feito com Master Rules Claude v9.2
Leitura: ~24 min
TL;DR
- Em 22 de outubro de 2026 a API do DeepSeek tem dois nomes de modelo, deepseek-flash e deepseek-v4-pro, ambos com 1 milhão de tokens de contexto, e uma única chave de API serve aos três agentes deste guia.
- OpenCode e Hermes ativam o DeepSeek por assistente guiado (/connect e hermes setup), enquanto o Kimi Code CLI exige registrar um provedor do tipo openai no config.toml.
- O preço por token dobra no horário de pico, que em Brasília cai entre 22h e 01h e entre 03h e 07h; concentrar sessões longas fora dessas faixas corta a conta pela metade.
Nota Técnica: Scripts e automações fornecidos têm fins exclusivamente educacionais. Teste sempre em ambiente controlado. @CanalQb não se responsabiliza por danos, perdas ou bloqueios decorrentes do uso indevido.
Uma chave de API, três agentes: o difícil é saber onde colá-la.
Em outubro de 2026 o DeepSeek trocou o modelo que responde pelo nome deepseek-flash sem mudar o nome nem o preço, e muita configuração antiga ainda aponta para apelidos aposentados. Aqui em @CanalQb organizamos o caminho completo para o Windows a partir das documentações oficiais: primeiro a instalação de OpenCode, Kimi Code CLI e Hermes Agent, depois a ativação do DeepSeek em cada um.
No fim existe um ajuste de horário que quase ninguém faz e que muda a conta do mês. Ele depende de uma regra de pico que a página de preços descreve em UTC, e vale a pena traduzi-la para o relógio de Brasília antes de deixar qualquer agente rodando durante a noite.
Quais são as soluções rápidas para os problemas mais comuns?
Seis falhas concentram quase todos os chamados nesse tipo de instalação: comando não reconhecido depois do instalador, shell Bash ausente, versão antiga do OpenCode, chave não encontrada, provedor com nome divergente e erro 400 em modo de raciocínio. Cada uma tem correção de poucos minutos e um detalhamento mais abaixo.
- kimi ou hermes não reconhecido: feche e abra um terminal novo para o PATH atualizado entrar em vigor. ver passo completo
- Bash not found no Kimi: instale o Git for Windows ou aponte KIMI_SHELL_PATH para o bash.exe. ver passo completo
- DeepSeek ausente no OpenCode: atualize para a versão 1.18.30 ou superior e rode /connect de novo. ver passo completo
- API key not set no Hermes: rode hermes model e grave a chave com hermes config set DEEPSEEK_API_KEY. ver passo completo
- Provider not found: a chave do provedor e o prefixo do modelo precisam ser idênticos. ver passo completo
- Erro 400 com raciocínio ligado: o campo reasoning_content precisa voltar na conversa; atualize o agente. ver passo completo
O que mudou no DeepSeek e qual modelo você deve chamar?
Em outubro de 2026 a API oficial do DeepSeek expõe dois nomes de modelo: deepseek-flash, atendido pela versão V4.1-Flash-1017, e deepseek-v4-pro, que corresponde à V4-Pro-0813. Ambos oferecem janela de 1 milhão de tokens, chamadas de ferramentas e modo de raciocínio, e funcionam tanto no formato OpenAI quanto no formato Anthropic.
Esse ponto de partida importa porque os três agentes deste tutorial só conversam com o DeepSeek pela API, e a API mudou duas vezes em poucas semanas. Segundo a página oficial de modelos e preços, o nome deepseek-flash passou a ser servido pelo snapshot 1017, e os nomes legados deepseek-v4-flash e deepseek-v4-flash-vision-exp continuam sendo aceitos, mas os modelos que eles identificavam foram aposentados: qualquer requisição feita com eles cai no Flash atual e é cobrada pelo preço do Flash. Na prática, uma configuração antiga não quebra de imediato, mas deixa de refletir o que você realmente está usando.
A diferença entre os dois modelos aparece no preço e nos recursos. O Flash aceita entrada de imagem e custa bem menos; o Pro não oferece visão, mas é a escolha para planejamento difícil e tarefas longas de código. Os valores abaixo vêm da página oficial, são cobrados por 1 milhão de tokens e valem fora do horário de pico; no pico, cada valor dobra.
| Modelo | Versão servida | Entrada com cache | Entrada sem cache | Saída | Visão |
|---|---|---|---|---|---|
| deepseek-flash | V4.1-Flash-1017 | US$ 0,003 | US$ 0,15 | US$ 0,60 | Sim |
| deepseek-v4-pro | V4-Pro-0813 | US$ 0,022 | US$ 0,66 | US$ 1,98 | Não |
Um exemplo concreto mostra o tamanho da diferença. Uma sessão que consome 2 milhões de tokens de entrada sem cache e gera 200 mil tokens de saída custa, fora do pico, 2 × US$ 0,15 + 0,2 × US$ 0,60, ou seja, US$ 0,42 no Flash. A mesma sessão no Pro custa 2 × US$ 0,66 + 0,2 × US$ 1,98, que dá cerca de US$ 1,72. O Pro sai 4,4 vezes mais caro na entrada e 3,3 vezes na saída, então vale reservá-lo para quando o Flash realmente não der conta.
Existe uma limitação que atrapalha quem copia tutoriais antigos: os nomes deepseek-chat e deepseek-reasoner, muito comuns em guias de 2025 e do início de 2026, não aparecem mais na lista oficial de modelos. Se um passo a passo mandar usar um deles, confirme o nome atual na página de preços antes de colar no arquivo de configuração. O erro típico é o agente responder normalmente nos primeiros testes e, semanas depois, falhar porque o apelido foi removido do servidor.
Para começar, deixe o deepseek-flash como padrão nos três agentes. Ele tem o melhor custo por tarefa, cobre leitura de código, edição de arquivos e execução de comandos, e você pode trocar para o Pro numa sessão específica quando precisar. Se quiser conferir o preço vigente no dia, a fonte é a página oficial de modelos e preços do DeepSeek; os números mudam sem aviso e nenhum guia deve ser tratado como tabela definitiva.
O que preparar no Windows antes de instalar os três agentes?
Antes de instalar qualquer agente, tenha três coisas prontas: um terminal PowerShell atualizado, o Git for Windows e uma chave de API do DeepSeek criada na plataforma oficial. Com esses itens no lugar, os instaladores de OpenCode, Kimi Code CLI e Hermes rodam sem interrupção, e você evita os erros de caminho e de shell que mais aparecem no Windows.
Passo 1: confirme Git e Node.js
Abra o PowerShell e rode os comandos abaixo para ver o que já existe na máquina. O resultado esperado é uma linha de versão para cada comando; se aparecer "não é reconhecido", o programa falta.
git --version
node --version
winget --versionO Git é obrigatório para o Kimi Code CLI, que usa o Git Bash como shell, e útil para o Hermes e o OpenCode. O Node.js só é necessário para os caminhos de instalação por npm; para o Kimi pelo npm a documentação exige a versão 22.19.0 ou mais nova. Se faltar algum, instale pelo winget com os comandos a seguir e depois feche e reabra o PowerShell. Erro comum: instalar e continuar na mesma janela; o PATH só é relido em terminais novos.
winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -ePasso 2: gere a chave no painel do DeepSeek
Entre em platform.deepseek.com, abra a área de chaves de API e crie uma chave nova com um nome reconhecível, como "agentes-windows". A chave aparece uma única vez; copie-a para um gerenciador de senhas antes de fechar a janela. Esse passo é necessário porque os três agentes cobram o uso direto na sua conta DeepSeek, e sem saldo ou crédito promocional as requisições falham mesmo com a chave correta. Quando funciona, a lista de chaves mostra a nova entrada com a data de criação. Erro comum: colar a chave num chat, num commit ou num arquivo de projeto; se isso acontecer, revogue a chave no painel e crie outra.
Passo 3: guarde a chave numa variável de ambiente
Em vez de colar a chave em cada ferramenta, grave-a uma vez como variável de ambiente do usuário. O comando setx persiste o valor para terminais futuros, e o Kimi Code CLI vai ler exatamente esse nome. Troque o texto de exemplo pela sua chave real e reabra o PowerShell depois.
setx DEEPSEEK_API_KEY "sk-cole-sua-chave-aqui"
# depois de reabrir o PowerShell:
echo $env:DEEPSEEK_API_KEYSe o segundo comando imprimir a chave, a variável está viva. Quando ele imprime uma linha vazia, o setx foi rodado na janela atual e o terminal ainda não foi reaberto, que é a causa mais comum de "chave não encontrada" logo no primeiro teste.
Um detalhe de análise própria que poupa tempo: cada agente trata a chave de um jeito diferente. O OpenCode guarda a chave no próprio armazenamento depois do /connect, o Kimi Code CLI só enxerga a variável de ambiente se o arquivo de configuração mandar ler pelo nome dela, e o Hermes guarda segredos no arquivo .env da sua pasta de dados. Ter a variável pronta serve ao Kimi e ao Hermes, e o OpenCode recebe a mesma chave colada uma única vez dentro do assistente.
Como instalar o OpenCode no Windows?
O OpenCode instala no Windows por npm, Scoop ou Chocolatey, e a documentação oficial recomenda o WSL como o caminho com melhor desempenho e compatibilidade total. Para quem prefere ficar no Windows nativo, o comando npm install -g opencode-ai basta; depois, opencode --version deve mostrar a versão 1.18.30 ou superior para funcionar bem com o DeepSeek.
Passo 1: escolha o método de instalação
A decisão depende do que você já usa. Quem tem Node.js instalado vai de npm, quem usa gerenciador de pacotes prefere Scoop ou Chocolatey, e quem quer o melhor desempenho segue o guia de WSL do próprio projeto. Os quatro caminhos entregam o mesmo executável opencode, então a escolha é de conveniência e de atualização.
| Método | Comando | Quando escolher |
|---|---|---|
| npm | npm install -g opencode-ai | Você já tem Node.js e quer atualizar com o mesmo comando mais tarde. |
| Scoop | scoop install opencode | Você usa Scoop para outras ferramentas de linha de comando. |
| Chocolatey | choco install opencode | Você usa Chocolatey e abre o PowerShell como administrador. |
| WSL | curl -fsSL https://opencode.ai/install | bash | Você quer o caminho recomendado pela documentação, dentro do Linux do WSL. |
Passo 2: instale e confirme a versão
Este guia segue o npm por ser o mais direto no Windows nativo. O comando baixa o pacote e registra o executável opencode no PATH global do npm. Ele é necessário aqui porque o DeepSeek só aparece no catálogo de provedores das versões recentes.
npm install -g opencode-ai@latest
opencode --versionO resultado esperado é um número de versão, e o guia de integração do DeepSeek pede 1.18.30 ou mais nova para evitar problemas de compatibilidade. Se o número for menor, repita o primeiro comando; se o comando opencode não for reconhecido, abra um terminal novo e confira com npm config get prefix se a pasta global do npm está no PATH.
Existe uma pegadinha de versões que a documentação do OpenCode destaca: o OpenCode 1 e o OpenCode 2 usam o mesmo comando opencode e não convivem lado a lado na instalação padrão. Se você já testou a versão 2 em algum momento, instalar a versão 1 por cima troca o executável, e a configuração do DeepSeek descrita neste guia foi escrita a partir da documentação oficial da versão 1, que é a que o DeepSeek cita. Quem preferir a versão 2 deve consultar a documentação própria dela antes de seguir os próximos passos.
Para o WSL, o projeto mantém uma página dedicada com a instalação do Linux e os cuidados de caminho entre os dois sistemas; vale lê-la se você pretende abrir projetos que ficam em pastas do Windows. Para o restante deste guia, o terminal pode ser o PowerShell com a instalação por npm ou o terminal do WSL com o instalador do projeto, e os comandos de ativação do DeepSeek são idênticos nos dois.
Como ativar o DeepSeek no OpenCode?
No OpenCode a ativação é guiada: abra o terminal, rode opencode, digite /connect, procure pelo provedor deepseek, cole a chave de API e escolha o modelo Flash na lista. O processo leva menos de dois minutos e não exige editar arquivo algum, porque o DeepSeek já faz parte do catálogo de provedores do OpenCode.
Passo 1: abra o OpenCode numa pasta de projeto
Vá até uma pasta de teste e inicie a interface. O OpenCode trabalha sobre o diretório atual, então iniciá-lo na pasta errada faz o agente enxergar arquivos que você não pretendia expor.
mkdir $HOME\teste-agentes
cd $HOME\teste-agentes
opencodeQuando funciona, a interface em tela cheia do terminal abre com uma caixa de entrada no rodapé. Erro comum: iniciar na raiz do disco ou na pasta de usuário inteira, o que deixa o agente indexar muito mais arquivos do que o necessário.
Passo 2: conecte o provedor com /connect
Na caixa de entrada digite /connect, escreva deepseek na busca e selecione o provedor. Em seguida cole a chave de API quando o assistente pedir. Esse passo grava a credencial no armazenamento do próprio OpenCode, e é por isso que ele não depende da variável de ambiente criada antes. O resultado esperado é uma mensagem de conexão concluída e, na etapa seguinte, a lista de modelos do DeepSeek.
Passo 3: escolha o modelo Flash
Selecione a entrada do Flash na lista. As páginas do DeepSeek descrevem essa opção de duas maneiras, como V4.1-Flash num guia e como V4-Flash em outro, porque a documentação foi atualizada em momentos diferentes; ambas se referem ao mesmo modelo de custo baixo, e o servidor atende pelo nome deepseek-flash. Para ver o identificador exato que o seu OpenCode usa, digite /models depois da conexão.
Passo 4: fixe o modelo no arquivo de configuração
Isto é opcional, mas evita escolher o modelo toda vez. O OpenCode lê um arquivo opencode.json global na pasta .config do seu perfil de usuário e outro na raiz de cada projeto. Escreva o modelo no formato provedor/identificador, trocando o texto de exemplo pelo identificador mostrado no /models.
{
"$schema": "https://opencode.ai/config.json",
"model": "deepseek/identificador-mostrado-no-models"
}Faça o teste com um pedido simples, como "Liste os arquivos desta pasta e explique em três linhas o que cada um faz". A tecla Tab alterna entre o modo de planejamento, que só sugere mudanças, e o modo de construção, que as aplica. Erro comum: o aviso Provider not found, que aparece quando o nome do provedor no arquivo e o prefixo do modelo não são idênticos; ambos precisam ser exatamente deepseek.
Como instalar o Kimi Code CLI no Windows?
O Kimi Code CLI instala no Windows com um único comando em PowerShell, desde que o Git for Windows esteja instalado antes do primeiro uso, porque a ferramenta usa o Git Bash como shell. Depois do script, kimi --version confirma o executável no PATH e o comando kimi abre a interface interativa no diretório do seu projeto.
Passo 1: tenha o Git for Windows no lugar
Se você seguiu a preparação, o Git já está instalado pelo winget. A documentação do Kimi Code é direta: instale o Git for Windows antes de abrir a ferramenta pela primeira vez, pois é o Git Bash que executa os comandos de shell que o agente pede. Sem ele, o primeiro comando de shell falha com a mensagem Bash not found.
Passo 2: rode o instalador oficial
No PowerShell comum, sem precisar de administrador, execute o comando abaixo. Ele baixa a versão mais recente, confere o checksum e coloca o executável kimi no PATH; por isso é o método que a documentação chama de recomendado e que dispensa ter Node.js. Como em qualquer script executado direto da internet, vale abrir o endereço no navegador e ler o conteúdo antes de rodar.
irm https://code.kimi.com/kimi-code/install.ps1 | iexPasso 3: confirme a instalação
Feche o PowerShell, abra um novo e rode o comando abaixo. O resultado esperado é a versão instalada. Se a resposta for kimi not found, o PATH ainda não foi relido ou o instalador rodou em outro usuário do Windows; um terminal novo no mesmo usuário resolve na maioria dos casos.
kimi --versionPasso 4: alternativas e ajustes finos
Quem já tem Node.js 22.19.0 ou superior pode instalar pelo npm com npm install -g @moonshot-ai/kimi-code, e atualizar depois com kimi upgrade. Se o Git Bash estiver numa pasta fora do padrão, grave o caminho do bash.exe na variável KIMI_SHELL_PATH, por exemplo com setx KIMI_SHELL_PATH "C:\Program Files\Git\bin\bash.exe", e reabra o terminal.
Atenção a uma confusão frequente de nomes: existe o Kimi Code CLI atual, escrito em TypeScript, e o antigo kimi-cli, instalado com uv tool install kimi-cli, que guarda a configuração em ~/.kimi. O Kimi Code CLI usa a pasta ~/.kimi-code, que no Windows fica dentro do seu perfil de usuário. Muitos tutoriais antigos citam o primeiro caminho, e editar o arquivo da pasta errada é um dos motivos de a configuração do DeepSeek "não pegar". O instalador deste passo, com o endereço contendo kimi-code, é o da ferramenta atual.
Como ativar o DeepSeek no Kimi Code CLI?
O caminho mais previsível é registrar o DeepSeek no arquivo config.toml como um provedor do tipo openai, apontando para a URL da API e para uma variável de ambiente com a chave. Depois você define um alias de modelo e o torna padrão, e o CLI trata sozinho o campo de raciocínio que os modelos DeepSeek devolvem.
Passo 1: abra o arquivo config.toml
O arquivo nasce na primeira execução do kimi, então rode o comando uma vez e saia com /exit. Depois abra o arquivo no editor com o comando abaixo. O CLI lê as credenciais apenas do arquivo de configuração e não usa variáveis do terminal por conta própria, e é isso que o próximo passo contorna.
notepad $HOME\.kimi-code\config.tomlPasso 2: adicione o provedor e o modelo
Acrescente o bloco abaixo, mantendo o que já existe no arquivo. O tipo openai fala o protocolo de chat compatível com OpenAI, que o DeepSeek oferece em https://api.deepseek.com. O campo api_key_env manda o CLI ler a chave da variável DEEPSEEK_API_KEY a cada requisição, assim a chave não fica escrita em texto puro no arquivo. A janela de contexto foi declarada em 1 milhão de tokens, valor conservador em relação ao informado na página de preços.
default_model = "deepseek/flash"
[providers.deepseek]
type = "openai"
base_url = "https://api.deepseek.com"
api_key_env = "DEEPSEEK_API_KEY"
[models."deepseek/flash"]
provider = "deepseek"
model = "deepseek-flash"
max_context_size = 1000000
display_name = "DeepSeek V4.1 Flash"
capabilities = ["thinking", "tool_use"]Se o arquivo já tiver uma linha default_model, mantenha apenas uma delas, porque a chave repetida invalida o TOML. As aspas em torno de deepseek/flash são obrigatórias, já que a barra e o ponto em nomes de chave exigem aspas nesse formato. Para um segundo alias com o Pro, copie o bloco de modelo, troque o alias e o campo model para deepseek-v4-pro e tire a capacidade de imagem se algum dia a declarar.
Passo 3: recarregue e teste
Salve o arquivo, abra um terminal novo para que a variável de ambiente entre no processo e faça um teste curto de uma única mensagem. O parâmetro -m escolhe o alias e -p executa uma instrução sem abrir a interface.
kimi -m deepseek/flash -p "Responda apenas: configuração ok"Se a resposta chegar, abra o kimi normalmente e use /model para alternar entre aliases durante a sessão. Se aparecer um erro citando a variável DEEPSEEK_API_KEY, ela está vazia nesse processo: rode echo $env:DEEPSEEK_API_KEY e, se vier vazio, refaça o setx e reabra o terminal. Um segundo caminho existe no próprio CLI: o comando /provider abre um gerenciador que importa provedores conhecidos a partir do catálogo público models.dev e pede só a chave; ele serve como atalho, mas o catálogo pode demorar a listar o identificador mais novo do DeepSeek, e nesse caso o bloco manual acima continua valendo. O comando /login, por sua vez, é para o serviço próprio do Kimi e não é necessário para usar o DeepSeek.
Como instalar o Hermes Agent no Windows?
O Hermes Agent, da Nous Research, tem três caminhos no Windows: o instalador desktop em pacote .appinstaller, o script nativo em PowerShell e o script Linux dentro do WSL2. O caminho mais curto para quem usa terminal é rodar iex (irm https://hermes-agent.nousresearch.com/install.ps1) no PowerShell e reabrir a janela para o comando hermes ser reconhecido.
Passo 1: escolha o caminho de instalação
O pacote desktop do site oficial traz o agente, o Python e as dependências suportadas já embutidos, e o primeiro uso não compila o ambiente base. O script de PowerShell clona o código-fonte, prepara o gerenciador uv e baixa versões fixas de Python, Node.js, ripgrep e FFmpeg. O terceiro caminho, o script para Linux, é para quem já trabalha dentro do WSL2. Para um tutorial de terminal, o script de PowerShell é o mais fácil de reproduzir e de depurar.
Passo 2: rode o instalador nativo
No PowerShell, execute o comando abaixo. O Windows consegue buscar um Git empacotado se ele estiver ausente, e as etapas aparecem em uma linha de status cada, com os detalhes gravados em logs\install.log dentro da pasta de dados do Hermes. O instalador também baixa por padrão as ferramentas de navegador; se não quiser isso, a opção -SkipBrowser as dispensa. Leia o script no navegador antes de rodar, como em qualquer instalador baixado e executado em memória.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Em execuções interativas o instalador abre o assistente de configuração ao final. Você pode ativar o DeepSeek ali mesmo, seguindo a seção seguinte, ou pular a etapa e voltar depois com hermes model. O código fica em %LOCALAPPDATA%\hermes\hermes-agent, o lançador em %LOCALAPPDATA%\hermes\bin e os seus dados em %LOCALAPPDATA%\hermes.
Passo 3: reabra o terminal e valide
Feche o PowerShell, abra um novo e rode hermes doctor, o comando de diagnóstico do projeto, que informa exatamente o que está faltando. O resultado esperado é uma lista de verificações sem pendências críticas. Se a resposta for hermes: command not found, o PATH não foi relido; um terminal novo costuma resolver, e o diagnóstico do instalador indica a pasta bin que precisa estar no caminho.
Passo 4: plano B pelo WSL2
Relatos de comunidade descrevem o suporte nativo ao Windows como o mais recente e menos testado, com mais chance de arestas. Se o instalador nativo travar, abra o terminal do WSL2 e use o script oficial para Linux, curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, que exige apenas o Git. Os comandos de configuração do DeepSeek são os mesmos nos dois ambientes; muda apenas a pasta de dados, que no WSL2 fica em ~/.hermes.
Como ativar o DeepSeek no Hermes Agent?
No Hermes você ativa o DeepSeek com o assistente hermes setup ou com hermes model: escolha DeepSeek como provedor, informe a chave, confirme a URL https://api.deepseek.com e selecione o modelo. Quem prefere linha de comando direta pode gravar a chave com hermes config set DEEPSEEK_API_KEY e definir provedor e modelo na configuração.
Passo 1: use o assistente guiado
O guia oficial do DeepSeek para o Hermes manda executar hermes setup, escolher a opção Quick Setup, selecionar DeepSeek como provedor, digitar a chave, informar a URL base https://api.deepseek.com e escolher o modelo; o exemplo da documentação usa o deepseek-v4-pro, e para economizar você pode escolher deepseek-flash no mesmo ponto. Há um detalhe de versão: dependendo da release instalada, o Quick Setup pode levar primeiro ao Nous Portal, o serviço próprio da Nous Research. Se isso acontecer, rode hermes model, que lista os provedores diretamente, ou escolha Full Setup no assistente.
Passo 2: configure por comandos
O Hermes separa segredos de configuração comum: a chave vai para o arquivo .env da pasta de dados e o resto para o config.yaml. O comando hermes config set decide o arquivo correto por você. Rode as três linhas abaixo, trocando o texto de exemplo pela sua chave.
hermes config set DEEPSEEK_API_KEY sk-cole-sua-chave-aqui
hermes config set model.provider deepseek
hermes config set model.default deepseek-flash
hermes config get modelA última linha imprime o que ficou gravado e serve de conferência: o provedor deve ser deepseek e o modelo deepseek-flash. Erro comum: digitar a chave com espaços ou aspas curvas coladas de um editor de texto, o que gera falha de autenticação mesmo com a chave certa.
Passo 3: confira o arquivo de configuração
Se preferir editar à mão, o arquivo config.yaml fica em %LOCALAPPDATA%\hermes. O bloco mínimo equivalente aos comandos anteriores é o seguinte, e o comando hermes config edit abre o arquivo no editor.
model:
provider: deepseek
default: deepseek-flashPasso 4: teste uma conversa
Execute hermes e faça uma pergunta curta; o banner inicial mostra o provedor e o modelo escolhidos. Para forçar a escolha em uma única chamada, use hermes chat --provider deepseek --model deepseek-flash. O Hermes exige um modelo com no mínimo 64 mil tokens de contexto, requisito que os 1 milhão de tokens do DeepSeek superam com folga. Se as respostas vierem vazias ou quebradas, a documentação aponta provedor, modelo ou autenticação errados e manda rodar hermes model de novo para confirmar os três.
Como testar os três agentes e controlar o custo do DeepSeek?
Teste cada agente com o mesmo pedido curto, confira no painel do DeepSeek se o consumo apareceu e só então libere tarefas longas. Para segurar a conta, mantenha o Flash como padrão, use o Pro apenas em planejamento difícil e evite os horários de pico, em que o preço por token dobra em relação ao restante do dia.
O teste padronizado evita comparar maçãs com laranjas. Use o mesmo pedido nos três, por exemplo "Liste os arquivos desta pasta e explique em três linhas o que cada um faz", e observe se o agente leu a pasta, respondeu em português e terminou sem erro de autenticação.
| Agente | Comando de teste | O que conferir |
|---|---|---|
| OpenCode | opencode, depois digitar o pedido | O modelo exibido é o Flash do DeepSeek e o agente lê a pasta. |
| Kimi Code CLI | kimi -m deepseek/flash -p "pedido" | A resposta chega sem erro citando DEEPSEEK_API_KEY. |
| Hermes | hermes chat --provider deepseek --model deepseek-flash | O banner mostra provedor e modelo, e a resposta não vem vazia. |
Depois dos testes, o assunto é o relógio. A página de preços define o pico como as faixas de 01h às 04h e de 06h às 10h em UTC, de segunda a sexta, sem contar feriados públicos chineses; todo o resto, incluindo os fins de semana inteiros, é fora do pico, com metade do preço. Em Brasília, que está três horas atrás de UTC, as faixas equivalem a 22h–01h e 03h–07h. A regra dos dias vale pela data em UTC, e esse é o ponto que costuma passar batido: a faixa das 22h às 01h é pico de domingo a quinta à noite, já que 22h de domingo em Brasília é 01h de segunda em UTC, e deixa de ser pico na sexta à noite, que já é sábado em UTC. A faixa da madrugada, das 03h às 07h, atinge os dias úteis normais. Quem programa à noite no meio da semana paga o dobro sem perceber.
O cache de entrada é a segunda alavanca de custo. O Flash cobra US$ 0,003 por milhão de tokens com cache contra US$ 0,15 sem cache, uma diferença de 50 vezes, e agentes de código repetem contexto a cada passo. Sessões longas na mesma pasta, sem trocar de modelo no meio, aproveitam mais o cache do que várias sessões curtas e dispersas. A limitação é que o cache depende de o início do pedido ser idêntico, então reorganizar instruções fixas no meio da conversa pode reduzir esse ganho.
Segurança também faz parte do controle. Todos os três agentes executam comandos e editam arquivos, e o conteúdo que eles leem viaja para os servidores do DeepSeek. Não rode o agente em pastas com segredos, mantenha a chave só em variável de ambiente, nunca a coloque em repositório e use os modos de permissão de cada ferramenta: o Kimi Code CLI começa no modo manual, que pede confirmação antes de alterar arquivos ou rodar comandos, e o OpenCode tem sua própria documentação de permissões. Se a chave vazar, revogue no painel e gere outra no mesmo minuto.
Perguntas frequentes sobre DeepSeek em agentes no Windows
O DeepSeek é gratuito nesses agentes?
Devo usar deepseek-flash ou deepseek-v4-pro?
Posso usar a mesma chave nos três agentes?
Preciso instalar o WSL para usar esses agentes?
Meu código vai para os servidores do DeepSeek?
Quais erros aparecem ao configurar e como resolver cada um?
Os erros abaixo cobrem as quatro categorias que mais travam este procedimento: instalação que não entra no PATH, shell ausente, configuração com nomes divergentes e autenticação sem chave. Cada cartão traz o sintoma como ele aparece na tela, a causa técnica, a correção copiável e uma prevenção para não repetir o problema na próxima instalação.
kimi not found (ou hermes: command not found)
Causa: o instalador gravou o executável e atualizou o PATH, mas a janela do terminal aberta antes da instalação mantém a lista antiga de pastas.
Solução: feche o PowerShell, abra um novo no mesmo usuário do Windows e rode kimi --version ou hermes doctor. Se persistir, confira se o instalador não foi executado em outra conta de usuário ou com permissões de administrador de outro perfil.
Prevenção: depois de qualquer instalador de linha de comando, abra sempre um terminal novo antes do primeiro teste.
Bash not found
Causa: o Kimi Code CLI usa o Git Bash como shell no Windows e não encontrou o bash.exe, seja porque o Git for Windows não está instalado, seja porque está numa pasta fora do padrão.
Solução: instale com winget install --id Git.Git -e ou, se o Git já existe em outro local, grave o caminho com setx KIMI_SHELL_PATH "C:\Program Files\Git\bin\bash.exe" e reabra o terminal.
Prevenção: instale o Git antes do Kimi e confirme com git --version.
DeepSeek não aparece no /connect do OpenCode
Causa: versão antiga do OpenCode, anterior ao suporte atual ao DeepSeek, ou conflito entre as versões 1 e 2, que usam o mesmo comando opencode.
Solução: rode npm install -g opencode-ai@latest, confirme que opencode --version mostra 1.18.30 ou superior e repita /connect, digitando deepseek na busca.
Prevenção: atualize o OpenCode antes de configurar novos provedores e evite manter duas gerações instaladas.
Provider not found
Causa: no opencode.json, o nome do provedor e o prefixo do modelo divergem, como declarar o provedor como deepseek e escrever o modelo com outro prefixo.
Solução: faça os dois coincidirem exatamente, por exemplo deepseek e deepseek/identificador, usando o identificador que o /models mostra.
Prevenção: copie o identificador do próprio /models em vez de digitar de memória ou de copiar de tutoriais antigos.
API key not set (Hermes) ou erro citando DEEPSEEK_API_KEY (Kimi)
Causa: a chave não chegou ao processo: no Hermes ela não foi gravada no .env, e no Kimi a variável não existe na janela atual porque o setx foi executado sem reabrir o terminal.
Solução: no Hermes rode hermes model ou hermes config set DEEPSEEK_API_KEY com a chave; no Kimi refaça o setx, abra um terminal novo e confirme com echo $env:DEEPSEEK_API_KEY.
Prevenção: valide a variável com echo antes de abrir qualquer agente.
Erro 400 em sessão com raciocínio ligado
Causa: relatos de comunidade indicam que a API recusa a requisição quando o campo reasoning_content devolvido pelo modelo não é reenviado no histórico, comportamento ligado ao modo de raciocínio e à troca silenciosa do snapshot em 17 de outubro.
Solução: atualize o agente para a versão mais recente, que trata esse campo; no Kimi Code CLI o tipo openai já o gerencia, e no OpenCode vale seguir a versão indicada pelo DeepSeek. Se persistir, abra uma nova sessão com /new.
Prevenção: mantenha os agentes atualizados e leia as notas de versão depois de qualquer anúncio de modelo do DeepSeek.
Gostou do passo a passo? Veja os vídeos de automação, agentes e ferramentas práticas em @CanalQb no YouTube e conte nos comentários qual agente você ativou primeiro.
Fontes e referências
Todas as informações foram conferidas em 22 de outubro de 2026 nas páginas abaixo; preços, versões e nomes de modelo mudam, então confirme nas fontes oficiais antes de decidir.
- DeepSeek API Docs: Your First API Call
- DeepSeek API Docs: Models & Pricing
- DeepSeek API Docs: Integrate with OpenCode
- DeepSeek API Docs: Integrate with Hermes Agent
- OpenCode: documentação de instalação e uso
- Kimi Code CLI: Getting started
- Kimi Code CLI: Providers and models
- Kimi Code CLI: Configuration files
- Hermes Agent: Installation
- Hermes Agent: Quickstart
- DEV Community: migração para o DeepSeek V4.1 Flash 1017 (relato de comunidade)
