🤖 Assistente de IA para Código Local com Qwen Code

📌 Pra que serve

Qwen Code é um agente de IA para coding open-source (Apache 2.0) que roda no seu terminal, navegador ou IDE sem mandar cada comando para servidores externos. Combine com Ollama para inferência local (zero APIs) ou use um provider de modelo hosted. Ideal para equipes em ambientes regulados, air-gapped ou que querem custos previsíveis.

🛠️ Passo a passo

1. Instale Node.js 20+

node --version && npm --version
Se não tem ou está abaixo de v20:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 20 && nvm use 20

2. Instale Qwen Code CLI

npm i -g @qwen-code/qwen-code@latest
qwen --version  # Deve retornar 0.25.2 ou 0.25.3 (outubro 2026)

3. Configure um modelo (escolha uma opção)

Opção A — Hosted (mais rápido):

qwen auth login
export QWEN_API_KEY="sua-chave-aqui"
export QWEN_MODEL="qwen3-max"

Opção B — Ollama Local (sem APIs externas):

## Instale Ollama
curl -fsSL https://ollama.com/install.sh | sh
Puxe um modelo de coding

ollama pull qwen2.5-coder:32b
Em outro terminal:

ollama serve
Configure as variáveis:

export OPENAI_BASE_URL="http://localhost:11434/v1"
export OPENAI_API_KEY="ollama"
export QWEN_MODEL="qwen2.5-coder:32b"

4. Primeira sessão

cd ~/seu-projeto
qwen
Dentro do chat:

> Explique o que o arquivo src/auth.ts faz

5. Use isolamento com worktree (importante!)

git worktree add ../feature-branch feature/nova
cd ../feature-branch
qwen --worktree  # Edições ficam isoladas

6. OpenCode como runner agnóstico (opcional)

npm i -g @opencode/cli
opencode init
Permite usar múltiplos providers sem amarrar a um só

7. Background jobs para tarefas longas

qwen --background "Refatore todos os componentes class em src/ para hooks"
qwen jobs list  # Acompanhe o progresso

💡 Dica: Comece local com
Ollama para aprender a ferramenta sem custos. Depois migre para hosted se precisar de modelos mais potentes. A maioria dos bugs (falta de contexto, respostas genéricas) vem de não rodar qwen da raiz do repositório — sempre entre no diretório do projeto primeiro.

🔗 Links e instalação

Documentação oficial Qwen Code: https://github.com/QwenLM/qwen-coding (verifique o README e releases)
OpenCode (provider-agnostic): https://github.com/opencode-ai/opencode
Ollama (inferência local): https://ollama.com
Instalação rápida: npm i -g @qwen-code/qwen-code@latest
Comando oficial Ollama: curl -fsSL https://ollama.com/install.sh | sh
Fonte do artigo original: https://shattered.io/self-hosted-ai-coding-assistant-qwen-code-2026/

⚠️ Versioning: OpenCode teve inconsistência de versões em outubro 2026 — sempre valide contra a página GitHub Releases antes de pinnar em CI. Evite @latest em pipelines; use versão explícita.