Seu assistente e agente de IA
particular no Windows

2. Configuração & Setup no Windows

Escolha o caminho ideal para você: a interface gráfica simples do App Desktop ou a velocidade do terminal.

Passo 1: Criar conta grátis no OpenRouter

Antes de tudo, você precisa da chave de conexão que liga seu assistente aos modelos de linguagem:

1. Acesse o site oficial do OpenRouter.ai ↗ e cadastre-se gratuitamente (via Google ou GitHub).
2. Vá para openrouter.ai/keys ↗ e clique em Create Key.
3. Dê um nome para sua chave (ex: "OpenCode App") e clique em criar.
4. Copie a chave gerada imediatamente (ela começa com sk-or-...) e guarde em local seguro. Ela só é exibida uma única vez.

wsl --install

curl -fsSL https://opencode.ai/install | bash
source ~/.bashrc

npm install -g opencode-ai

[System.Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY', 'sk-or-v1-sua-chave-aqui', 'User')

Passo 2: Governança do Projeto (AGENTS.md)

No App Desktop ou no terminal, ao abrir um projeto novo pela primeira vez, o assistente perguntará se deseja inicializar as regras de governança. Alternativamente, você pode rodar o comando /init.

Isso criará o arquivo AGENTS.md na raiz da sua pasta. Nele, você pode escrever regras simples em português (ex: "Não use banco de dados MySQL, prefira SQLite", "mantenha os arquivos pequenos e explicados"). A IA lerá essas instruções antes de qualquer alteração, garantindo total controle.

3. Guia de Uso Avançado & Boas Práticas

Comandos, truques e gerenciamento inteligente para extrair a máxima produtividade.

Comandos Essenciais do Terminal OpenCode

Otimizando seus Gastos no OpenRouter

Se você optar por usar modelos pagos além dos modelos free, use a estratégia de alternância inteligente para economizar:

• Use os modelos gratuitos hy3 ou nemotron-3-ultra para tarefas repetitivas, perguntas de documentação e revisão simples.
• Use o modelo deepseek/deepseek-v4-flash ou mimo-v2.5 para desenvolvimento ativo devido ao custo de entrada extremamente baixo (~$0.09 a $0.10 por milhão de tokens).
• Reserve o deepseek/deepseek-v4-pro, claude/claude-opus-4.8 ou gpt-5.5 para tarefas de grande complexidade arquitetural, refatorações multi-arquivo ou debug profundo.

4. Templates de Prompt Prontos

Copie, adapte as variáveis entre colchetes [ ] e use diretamente no OpenCode para acelerar suas entregas.

Crie uma API REST em [Node.js/Python/Go] com os seguintes endpoints:
- GET /api/items (listar todos)
- POST /api/items (criar um item)
- DELETE /api/items/:id (deletar item)

Use [SQLite/PostgreSQL] como banco. Inclua:
- Validação de dados de entrada
- Tratamento de erros estruturado
- Um README.md detalhando como rodar a aplicação

Crie um script em Python que:
1. Leia todos os arquivos PDF no diretório atual
2. Extraia campos específicos: Data, Valor Total, CNPJ e Nome do Cliente
3. Salve esses resultados estruturados em uma planilha Excel (.xlsx) na pasta ./relatorios/
4. Adicione tratamento de erro para ignorar arquivos corrompidos

Revise o código em @[caminho/do/arquivo] e identifique:
1. Problemas latentes de segurança (ex: SQL injection, XSS ou vazamento de segredos)
2. Gargalos de performance em loops ou chamadas de banco
3. Violações de boas práticas do ecossistema
Apresente sugestões de código corrigido.

Explique detalhadamente o que o código em @[caminho/do/arquivo] faz.
Imagine que você está explicando para um desenvolvedor iniciante (noob-friendly). 
Inclua:
1. Um resumo da responsabilidade da classe/função
2. O fluxo passo a passo dos dados
3. O significado das principais variáveis

5. Governança Local de IA com Okam CLI

Implemente regras de governança estritas, controle sessões e configure hooks automatizados no seu ambiente de IA.

O que é o Okam CLI?

O Okam é uma ferramenta complementar e open-source para a governança local de agentes de IA. Ele atua como um gerenciador de diretrizes ("caderno de regras e memórias"), garantindo que os assistentes de IA respeitem as convenções do seu projeto e executem ações automáticas de segurança, como evitar commits com segredos expostos.

1. Instalação Rápida

Instale o Okam globalmente via npm no terminal (PowerShell ou WSL). Requer Node.js >= 18:

npm install -g okam-cli

Verifique a versão para certificar a correta instalação:

okam --version

2. Inicializando no seu Projeto

Navegue até a raiz do seu código e execute o setup inicial:

okam init

Isso gerará o arquivo local de configuração .okamrc.

3. Automação de Governança com Hooks (Ganchos)

Os hooks do Okam permitem disparar comandos no terminal automaticamente antes (pre-command) e depois (post-command) de cada interação com a IA:

hooks:
  pre-command:
    # Atualiza as ramificações locais antes de propor modificações
    - "git fetch origin"
  post-command:
    # Roda o validador de sintaxe ou testes automaticamente para checar a IA
    - "npm run lint && npm test"

4. Auditoria de Código com Pipes do Git

Você pode encadear comandos no terminal para submeter trechos ou o diff completo para revisão da IA antes de fechar um commit:

git diff --cached | okam run "revise este diff e aponte problemas de segurança, credenciais ou segredos expostos"

5. Estendendo com Skills

Skills são diretórios contendo pacotes estruturados de instruções (como regras de Clean Code ou Checklists TDAH). Instale-as facilmente:

# Instalar uma skill a partir do repositório
okam skill install checklists

# Listar skills atualmente ativas na sessão
okam skill list