Instalação — passo a passo

Instalar o Kirat

O Claude pode ser usado de três formas, e em cada uma o Kirat é instalado de um jeito diferente. Descubra primeiro qual é a sua e siga só esses passos. A maioria das pessoas precisa de uma.

Tutorial em vídeo com capítulos, cerca de 7 minutos. Legendas em CC.

Onde você conversa com o Claude?

Abra o app do Claude. No topo, você vê as abas Chat, Cowork e Code. Em Code, o seletor abaixo da caixa de mensagem mostra Local ou Cloud.

A · cerca de 2 minutos App do Claude, aba Chat A janela de chat normal no Mac ou no Windows. Extensão para desktop → B · cerca de 10 minutos Aba Code com “Local”, ou Claude Code em um terminal ou no VS Code O Claude trabalha com arquivos do seu computador. Plugin do Claude Code → C · cerca de 10 minutos Aba Code com “Cloud”, claude.ai/code no navegador ou Code no app para celular O Claude trabalha nos servidores da Anthropic. Ambiente de nuvem →

Você usa mais de uma? Configure cada uma. A extensão não chega às sessões do Code, e nada no seu computador chega a uma sessão na nuvem.

Não compatível: o chat do claude.ai no navegador, o chat nos apps do Claude para celular e as tarefas do Cowork que rodam na nuvem.

Antes de começar: duas chaves de API

O Kirat usa as suas próprias chaves. A OpenAI e o Google cobram diretamente de você o que for usado; nós nunca vemos as suas chaves. Obtê-las é a parte demorada, por causa dos formulários de cadastro e de faturamento dos provedores.

OpenAI: em platform.openai.com, abra API keys e crie uma chave. Ative o faturamento e defina um limite mensal; um projeto separado para o Kirat é uma boa ideia.
Google Gemini: em aistudio.google.com, clique em Get API key. Ative o faturamento do projeto associado e defina um orçamento.
Deixe as duas chaves à mão (por exemplo, no seu gerenciador de senhas). Você vai informá-las no próximo passo.

Opcional, permissões mínimas: na OpenAI, basta uma chave restrita (Restricted), com “List models” em Read e “Model capabilities” em Request, e todo o resto em None. Uma chave do Gemini criada no Google AI Studio já vem restrita à API do Gemini.

App do Claude, aba Chat

Descompacte o download (Windows: clique com o botão direito → Extrair Tudo…; Mac: clique duas vezes). Você obtém uma pasta chamada kirat.
No app do Claude, abra Settings → Extensions → Advanced settings e clique em Install Extension…. Escolha o arquivo .mcpb da pasta kirat. Ou arraste o arquivo para a página Extensions.
Informe as duas chaves de API e clique em Install. O app avisa que a extensão não é verificada pela Anthropic. Isso é normal para toda extensão instalada a partir de um arquivo.
Abra um chat novo e digite: Use the Kirat extension and call kirat_status. Os dois membros devem estar disponíveis, e a verificação das chaves deve mostrar ok para as duas.

Os modelos prontos (decide, review, critique, brainstorm) ficam no botão + da caixa de mensagem.

Aba Code com “Local”, ou Claude Code em um terminal ou no VS Code

Este caminho precisa de um comando em um terminal. As sessões locais da aba Code e o Claude Code compartilham as configurações, então você instala uma vez para os dois.

Descompacte o download e mova a pasta kirat para a sua pasta pessoal (Mac: /Users/<usuário>, Windows: C:\Users\<usuário>). Deixe-a lá: o Claude Code executa o Kirat a partir dessa pasta. Se o seu nome de usuário do Windows tiver espaço, use C:\kirat e escreva C:/kirat/claude-code no comando abaixo.
Abra um terminal (Mac: o app Terminal; Windows: PowerShell) e digite node --version. Se aparecer v20 ou superior, continue. Caso contrário, instale a versão LTS a partir de nodejs.org e abra um terminal novo.
Execute este comando no terminal:
claude plugin install kirat --marketplace ~/kirat/claude-code
Se claude não for reconhecido, instale primeiro o Claude Code (veja code.claude.com, Quickstart). Se o comando for antigo demais, execute antes claude update.
Informe as duas chaves quando forem pedidas. Se nada for pedido, digite /plugin configure kirat@kirat em uma sessão do Claude Code no terminal.
Abra uma sessão local nova (ou reinicie o Claude Code) e digite: Use the Kirat extension and call kirat_status.

Modelos no Claude Code: /kirat:decide, /kirat:review, /kirat:critique, /kirat:brainstorm.

Sessões na nuvem: aba Code com “Cloud”, claude.ai/code, app para celular

Tudo acontece nas configurações do seu ambiente de nuvem, no navegador ou no app do Claude. Sem terminal. Você faz isso uma vez por ambiente; depois, toda sessão nova nele tem o Kirat.

Abra as configurações do ambiente. No app do Claude: Code → o seletor de ambiente abaixo da caixa de mensagem → Cloud → passe o mouse sobre o seu ambiente → ícone de engrenagem. No claude.ai/code é o mesmo seletor abaixo da caixa de mensagem: passe o mouse sobre o ambiente e clique no ícone de configurações.

Adicione as suas chaves como network secrets. Em Network secrets, clique duas vezes em Add secret e mantenha o tipo Bearer:

Name	Allowed websites	Nome do header	Prefix	Value
OpenAI	`api.openai.com`	`Authorization`	`Bearer`	a sua chave da OpenAI
Gemini	`generativelanguage.googleapis.com`	`x-goog-api-key`	vazio (apague)	a sua chave do Gemini

Ninguém em uma sessão consegue ler essas chaves, nem mesmo o Claude. Nos planos Team e Enterprise, a seção pode não aparecer ou oferecer só um formulário curto; nesse caso, peça ao seu administrador ou informe as chaves em Environment variables, uma por linha: KIRAT_OPENAI_API_KEY=… e KIRAT_GEMINI_API_KEY=… (qualquer pessoa que use o ambiente consegue lê-las).

Acesso à rede. Se estiver em Full, não há nada a fazer. Caso contrário, escolha Custom, marque Also include default list of common package managers e adicione kirat.ai aos domínios permitidos. Com variáveis de ambiente em vez de network secrets, adicione também api.openai.com.
Script de configuração. No seu download, abra START-HERE.html (clique duas vezes, ele abre no navegador) e clique em Copy setup block. Cole no topo do campo Setup script, acima do que já estiver lá.

O endereço de download no bloco faz parte da sua compra: não o publique.
Salve e abra uma sessão nova nesse ambiente. Essa primeira sessão executa a configuração e normalmente ainda não mostra o Kirat, porque começou antes de a configuração terminar. Abra uma segunda sessão nova e digite: Call kirat_status. Os dois membros devem estar disponíveis, e a verificação das chaves deve mostrar ok. A partir daí, toda sessão nova tem o Kirat.

Não funcionou? O kirat_status indica qual chave ou host verificar. Se o Kirat ainda não aparecer na segunda sessão, o log de configuração mostra “Kirat setup failed” e o motivo. Depois de corrigir, altere o script de configuração (uma linha vazia basta); senão, as sessões novas mantêm o estado antigo.

Antes de depender disso, leia os limites na nuvem: entre outras coisas, o orçamento diário conta por sessão, então defina limites de gastos na OpenAI e no Google.

Ainda com problemas?

O Claude não conhece o Kirat: verifique qual caminho você usa (seção 01). Uma extensão da aba Chat não aparece nas sessões do Code.
Um membro não está disponível: a chave de API dele está faltando ou errada. O kirat_status diz qual.
As chamadas são bloqueadas: o orçamento diário acabou. Aumente-o nas configurações do Kirat ou espere até o dia seguinte (UTC).

O README.md do seu download cobre configurações, custos, atualizações e outros problemas (em inglês). O Kirat é oferecido sem suporte. Se ele não funcionar em um ambiente compatível, você pode pedir reembolso em até 14 dias: escreva para support@kirat.ai com o número do pedido e a saída do kirat_status (ela nunca contém as suas chaves).