OpenCode com Claude API

Tutorial de configuração do OpenCode para conectar ao Claude API da 1折AI, incluindo endereço, chave e modelo, com escolha de protocolo, exemplos de configuração, etapas de verificação e erros comuns.

Use a funcionalidade de provedor personalizado do OpenCode para conectar à 1折AI. Primeiro crie uma chave de API e confirme os modelos disponíveis atualmente; os IDs de modelo abaixo são exemplos, ajuste-os conforme as permissões da sua chave.

Data de verificação da configuração oficial: 2026-10-15. A configuração abaixo foi organizada com base na documentação oficial; a verificação ponta a ponta neste site ainda não foi concluída; conclua primeiro uma breve pergunta e verificação de chamada de ferramenta antes de usá-la em tarefas longas. Modelos OpenAI / GPT já estão disponíveis, a lista de modelos e preços está em descrição dos modelos.

Configuração do OpenCode v1

Com base nos Providers oficiais v1: execute /connect, escolha Other, insira o ID do provedor onezhe e preencha a chave de API deste site. No projeto opencode.json, faça merge:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "onezhe": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "1折AI",
7
      "options": { "baseURL": "https://1zheai.com/v1" },
8
      "models": {
9
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
10
      }
11
    }
12
  }
13
}

Em seguida, /models selecione o modelo desse provedor. /connect apenas salva as credenciais, não substitui a configuração do provedor. Aqui é escolhido explicitamente o SDK de Chat Completions; não pode ser trocado incorretamente pelo @ai-sdk/openai usado para Responses. A documentação oficial também permite referenciar variáveis de ambiente através de options.apiKey: "{env:ONEZHE_API_KEY}".

Configuração do OpenCode v2

Com base nos Providers oficiais v2, use os campos nativos v2, não podem ser misturados com o v1 acima. No projeto opencode.jsonc, faça merge:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "providers": {
4
    "onezhe": {
5
      "name": "1折AI",
6
      "env": ["ONEZHE_API_KEY"],
7
      "package": "@opencode/ai/providers/openai-compatible",
8
      "settings": { "baseURL": "https://1zheai.com/v1" },
9
      "models": {
10
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
11
      }
12
    }
13
  }
14
}

Forneça ONEZHE_API_KEY no ambiente do processo que inicia o OpenCode e depois /models selecione onezhe/claude-sonnet-4-6. A principal diferença do v2 é providers, package, settings, em vez de provider, npm, options do v1. Primeiro use opencode --version para confirmar a versão principal utilizada.

Se quiser usar o Anthropic nativo, o v1 oficial permite sobrescrever provider.anthropic.options.baseURL, o exemplo inclui /v1; o v2 lista @opencode/ai/providers/anthropic-compatible. Este tutorial segue uma configuração compatível com OpenAI explícita; não pode trocar o protocolo com base no nome do modelo nem prometer que cache e chamadas de ferramenta já foram verificados.

Verificação da conexão e resolução de problemas

Salve e recarregue a configuração, confirme que o provedor atualmente selecionado é onezhe ou o modelo personalizado que você adicionou.
Envie uma pergunta curta, confirme que consegue obter uma resposta; em seguida tente uma pequena tarefa reversível, confirme separadamente a chamada de ferramenta e a conversa com múltiplas rodadas.
Abra o log de chamadas, verifique o horário da requisição, o modelo, o status e o uso. Uma resposta de texto bem-sucedida não significa que todas as capacidades dos Agentes já são compatíveis.
Ao encontrar 404, verifique se o endereço e o protocolo deste artigo são compatíveis; ao encontrar 401, verifique a origem da chave e se o processo leu as variáveis de ambiente; ao encontrar 429, consulte as informações de limitação de taxa antes de tentar novamente. Mais casos em códigos de erro e resolução de problemas.

A chave deve ser armazenada apenas no ambiente local ou no armazenamento de credenciais da ferramenta; não a envie para repositórios de código, capturas de tela ou logs públicos. Serviços em segundo plano podem não herdar as variáveis de ambiente do terminal; modelos auxiliares, busca e outras ferramentas também podem ter configurações de provedor independentes, que precisam ser verificadas separadamente.

Custos e outras formas de conexão

Consulte os preços em tempo real da Claude API e as regras de cobrança. Para outros clientes, retorne ao diretório de conexão de ferramentas; para escrever seu próprio programa, use o SDK e guia de desenvolvimento.