README.pt-BR.md

🤖 Qwen Code OAuth Plugin para OpenCode

Autentique o OpenCode CLI com sua conta qwen.ai. Este plugin permite usar o modelo coder-model com 1.000 requisições gratuitas por dia — powered by Qwen 3.6 Plus com suporte a vídeo e visão. Sem API key ou cartão de crédito!

🇺🇸 Read in English | 📜 Changelog

✨ Funcionalidades

• 🔐 OAuth Device Flow - Autenticação segura via navegador (RFC 8628)
• 🆓 1.000 req/dia grátis - Cota gratuita renovada diariamente à meia-noite UTC
• ⚡ 60 req/min - Rate limit de 60 requisições por minuto
• 🧠 1M de contexto - Suporte a contextos massivos para grandes projetos
• 🔄 Auto-refresh - Tokens renovados automaticamente antes de expirarem
• ⏱️ Confiabilidade - Throttling de requisições e retry automático para erros temporários
• 🔗 Compatível com qwen-code - Reutiliza credenciais de ~/.qwen/oauth_creds.json

🚀 Instalação

Edite ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-qwencode-auth"]
}

É isso! O OpenCode instalará o plugin automaticamente ao iniciar.

Métodos alternativos de instalação

Via npm (versão explícita)

{
  "plugin": ["opencode-qwencode-auth@latest"]
}

Via repositório Git

{
  "plugin": ["opencode-qwencode-auth@git+https://github.com/gustavodiasdev/opencode-qwencode-auth.git#main"]
}

Versão específica

{
  "plugin": ["opencode-qwencode-auth@1.3.0"]
}

⚠️ Limites e Quotas

• Rate Limit: 60 requisições por minuto
• Cota Diária: 1.000 requisições por dia (reset à meia-noite UTC)
• Web Search: 200 requisições por minuto, 1.000 por dia (quota separada)

Nota: Estes limites são definidos pela API Qwen OAuth e podem mudar. Para uso profissional com quotas maiores, considere usar uma API Key do DashScope.

🔑 Uso

1. Login

Execute o comando abaixo para iniciar o fluxo OAuth:

opencode auth login

2. Selecione o Provider

Escolha "Other" e digite qwen-code.

3. Autentique

Selecione "Qwen Code (qwen.ai OAuth)".

• Uma janela do navegador abrirá para você autorizar.
• O plugin detecta automaticamente quando você completa a autorização.
• Não precisa copiar/colar códigos ou pressionar Enter!

🎯 Modelos Disponíveis

Modelo de Código

Modelo	Contexto	Max Output	Recursos
coder-model	1M tokens	Até 64K tokens	Qwen 3.6 Plus — suporte a vídeo e visão

Nota: Este plugin está alinhado com o cliente oficial qwen-code. O alias coder-model mapeia para o Qwen 3.6 Plus com raciocínio híbrido, visão e suporte a entrada de vídeo.

Usando o modelo

opencode --provider qwen-code --model coder-model

🔧 Solução de Problemas

"Invalid access token" ou "Token expired"

O plugin geralmente gerencia a renovação automaticamente. Se você vir este erro imediatamente:

1. Re-autentique: Execute opencode auth login novamente.
2. Limpe o cache: Delete o arquivo de credenciais e faça login de novo:

   rm ~/.qwen/oauth_creds.json
   opencode auth login

Limite de requisições excedido (erros 429)

Se você atingir o limite de 60 req/min ou 1.000 req/dia:

• Rate limit (60/min): Aguarde alguns minutos antes de tentar novamente
• Cota diária (1.000/dia): Aguarde até a meia-noite UTC para o reset da cota
• Web Search (200/min, 1.000/dia): Quota separada para ferramenta de busca web
• Considere usar uma API Key do DashScope para uso profissional com quotas maiores

Habilite Logs de Debug

Se algo não estiver funcionando, você pode ver logs detalhados configurando a variável de ambiente:

OPENCODE_QWEN_DEBUG=1 opencode

🛠️ Desenvolvimento

# Clone o repositório
git clone https://github.com/gustavodiasdev/opencode-qwencode-auth.git
cd opencode-qwencode-auth

# Instale dependências
bun install

# Rode os testes
bun run tests/debug.ts full

Estrutura do Projeto

src/
├── qwen/               # Implementação OAuth
├── plugin/             # Gestão de token & cache
├── utils/              # Utilitários de retry, lock e logs
├── constants.ts        # Modelos e endpoints
└── index.ts            # Entry point do plugin

📄 Licença

MIT

---

Feito com ❤️ para a comunidade OpenCode