Provedores e chaves

O Neuro Harness usa o sistema de provedores do DeepSeek Harness. Esta página mostra onde as chaves ficam, como importar as que você já tem e como escolher o modelo de cada tarefa.

Provedores

Kimi, DeepSeek, OpenRouter, Gemini, OpenAI, MiniMax, GLM, OpenCode, NVIDIA e Meta, por chave de API, e ChatGPT/Codex por login.

Onde ficam as chaves

As chaves ficam no cofre do Harness, ~/.neuro-harness/dsh/.credentials.yaml.

• Só o seu usuário lê o arquivo.
• As chaves nunca entram no ambiente das sessões.
• Variáveis de provedor do seu terminal, como OPENAI_API_KEY, são ignoradas pelas sessões.

Adicionar uma chave pelo painel

1. No painel, abra Configurações → Modelos.
2. Escolha o provedor e cole a chave de API.
3. Numa sessão, escolha o modelo no seletor de modelo.

Importar chaves do Hermes e do OpenCode

Se você já usa o Hermes ou o OpenCode, importe as chaves deles para o cofre. O instalador faz isso sozinho quando encontra os arquivos.

Terminal

neuro-harness credenciais --dry-run   # testa cada chave e mostra o que gravaria, sem gravar
neuro-harness credenciais             # grava no cofre as chaves aceitas

O comando lê três arquivos:

• ~/.hermes/.env
• ~/.local/share/opencode/auth.json
• ~/.config/opencode/meta-api-key

Como ele trata cada chave:

• Teste: cada chave é testada no próprio provedor. Só o código HTTP aparece, nunca o valor.
• Gravação: só as chaves aceitas são gravadas. Antes de gravar, o cofre atual é copiado para .credentials.yaml.bak.
• Chaves que já estão no cofre: ficam como estão, a menos que você use --sobrescrever.

Referência no cofre	Provedor	De onde vem
KIMI_API_KEY	kimi-coding (Kimi for Coding)	Hermes KIMI_API_KEY ou OpenCode kimi-for-coding
OPENROUTER_API_KEY	openrouter	Hermes
ZAI_API_KEY	zai (plano de código GLM)	OpenCode zai-coding-plan ou Hermes GLM_API_KEY
MINIMAX_API_KEY	minimax	Hermes ou OpenCode minimax-coding-plan
GEMINI_API_KEY	google	Hermes ou OpenCode google
OPENAI_API_KEY	openai	Hermes
OPENCODE_API_KEY	opencode (Zen)	Hermes OPENCODE_ZEN_API_KEY ou OpenCode
OPENCODE_GO_API_KEY	opencode-go	Hermes ou OpenCode
NVIDIA_API_KEY	nvidia	Hermes
META_API_KEY	meta	~/.config/opencode/meta-api-key
DEEPSEEK_API_KEY	deepseek	Hermes, ou o que você digitar no painel

Todas as opções do comando estão em neuro-harness credenciais.

Entrar por login (OAuth)

Os logins do ChatGPT/Codex (openai-codex), do Kimi CLI e do MiniMax não são importados. Neles, o token de renovação é único: se duas ferramentas usarem o mesmo, uma derruba a outra.

Para usar esses provedores, entre pelo painel, em Configurações → Modelos.

Assinaturas fora dos apps oficiais

Usar uma assinatura fora dos apps oficiais depende dos termos de cada provedor. A chave de API é o caminho sem esse risco.

Escolher o modelo por tarefa

• Revisão de vídeo: o revisor lê imagens dos quadros. Use um modelo com entrada de imagem, como kimi-coding/kimi-for-coding, os modelos Gemini ou os modelos Claude via OpenRouter.

• Modelos que exigem raciocínio: alguns só respondem com o raciocínio ligado. Escolha um nível de raciocínio no seletor de modelo.

• Tarefas sem interface: passe o modelo no formato provedor/modelo.

  Terminal

  neuro-harness run "Liste os perfis do neuro-mv-edit" --modelo kimi-coding/kimi-for-coding

Saldo e erros comuns

Mensagem	O que significa	O que fazer
MISSING_CREDENTIAL	Não há chave para esse provedor	Importe com neuro-harness credenciais ou digite a chave em Configurações → Modelos
QUOTA: Insufficient Balance ou Insufficient balance or no resource package	A chave é válida, mas a conta está sem saldo ou sem plano	Recarregue a conta no provedor ou escolha outro modelo
INVALID_REQUEST … always engages in thinking	O modelo exige raciocínio ligado	Escolha um nível de raciocínio no seletor de modelo

Para conferir quantas chaves estão no cofre, rode neuro-harness doctor. Ele mostra os nomes das referências, nunca os valores.