---
title: "OpenCode com Claude API"
description: "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."
headingIds: {"Configuração do OpenCode v1":"section-1","Configuração do OpenCode v2":"section-2","Verificação da conexão e resolução de problemas":"section-3","Custos e outras formas de conexão":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Use a funcionalidade de provedor personalizado do OpenCode para conectar à 1折AI. Primeiro [crie uma chave de API](/pt/docs/api-keys/) e confirme os [modelos disponíveis atualmente](/pt/docs/models/); os IDs de modelo abaixo são exemplos, ajuste-os conforme as permissões da sua chave.

<Note>
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](/pt/docs/models/).
</Note>

## Configuração do OpenCode v1

Com base nos [Providers oficiais v1](https://opencode.ai/docs/providers/): 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:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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](https://opencode.ai/v2/docs/providers), use os campos nativos v2, não podem ser misturados com o v1 acima. No projeto `opencode.jsonc`, faça merge:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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

1. Salve e recarregue a configuração, confirme que o provedor atualmente selecionado é `onezhe` ou o modelo personalizado que você adicionou.
2. 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.
3. Abra o [log de chamadas](/pt/docs/usage-logs/), 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.
4. 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](/pt/docs/troubleshooting/).

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](https://1zheai.com/en/pricing/) e as [regras de cobrança](/pt/docs/pricing-explained/). Para outros clientes, retorne ao [diretório de conexão de ferramentas](/pt/docs/integrations/); para escrever seu próprio programa, use o [SDK e guia de desenvolvimento](/pt/docs/guides/).