Downloads
Instale o Clavitor na sua máquina.
A CLI dá aos seus agentes acesso delimitado ao seu cofre. O proxy injeta credenciais nos pedidos HTTPS de forma transparente. Ambos são transferências pequenas e autónomas.
Download
Clavitor CLI
Fetch credentials, generate TOTP codes, store new secrets.
| Platform | Size | SHA-256 | |
|---|---|---|---|
| Linux · amd64 | 4.4 MB | 4fdef0ff80c5c072… | Download |
| Linux · arm64 | 3.2 MB | 1e064bf6ced4719e… | Download |
| macOS · Intel | 2.2 MB | 5fa5b5d769934295… | Download |
| macOS · Apple Silicon | 2.1 MB | e31f85841aae70ee… | Download |
| Windows · amd64 | 1.7 MB | a12d5808857b4c2b… | Download |
| FreeBSD · amd64 | 4.4 MB | 17b0c47a8cbe3fc2… | Download |
Clavitor Proxy
Local HTTPS proxy that injects credentials into agent requests.
| Platform | Size | SHA-256 | |
|---|---|---|---|
| Linux · amd64 | 4.7 MB | aec16a6e5f30db5e… | Download |
| Linux · arm64 | 3.5 MB | 4deba36426f4f116… | Download |
| macOS · Intel | 2.3 MB | fce298815c9f7919… | Download |
| macOS · Apple Silicon | 2.2 MB | 4dcbe94b6b94cbe9… | Download |
| Windows · amd64 | 1.8 MB | f640d67851aa786c… | Download |
| FreeBSD · amd64 | 4.7 MB | 670b2595a7fe8c00… | Download |
The macOS and Windows downloads are archives: the program and the two libraries of its FIPS crypto module, which stay in the same folder.
Download SHA256SUMS · verify with sha256sum -c SHA256SUMS
Extensão de navegador
Prefere preencher credenciais no navegador? A extensão Clavitor insere senhas, passkeys, cartões e códigos únicos no campo que realmente os deseja — enquanto seu cofre permanece remoto, sem nada em cache ou descriptografado em sua máquina.
Para o Chrome. Firefox e Safari em breve.
Configure um agente
Dois passos. Menos de um minuto de uma nova instalação do CLI a uma identidade de agente funcional.
1. Crie o agente no seu cofre
Na interface web do seu cofre, aceda a Clientes → + Novo cliente. Dê um nome ao cliente (por exemplo, "Claude Code") e escolha a que entradas ele pode aceder. O Clavitor devolve um blob de inscrição e uma chave de inscrição. O blob é selado (codifica o endereço do cofre e a identidade do agente); a chave é o único segredo que o abre. Trate a chave como uma palavra-passe: entregue-a diretamente à máquina onde o agente corre e depois descarte-a.
2. Inicialize o CLI na máquina do agente
$ clavitor-cli init '<blob>' Enrollment key:
Cole o blob entre as aspas. A CLI pede então a chave (nunca é aceite na linha de comandos e não é ecoada), abre o blob localmente, guarda a sua configuração em ~/.config/clavitor/config (ou $XDG_CONFIG_HOME/clavitor/config) e recusa utilizá-la se alguém além da sua conta de utilizador a conseguir ler. Não volta a precisar do blob nem da chave. A secção seguinte mostra como o agente usa a CLI a partir daqui.
Configure o proxy
Para agentes que já falam HTTP/HTTPS — Claude Desktop, scripts personalizados, qualquer coisa que use requests ou fetch. O proxy fica entre o agente e a API a montante, resolvendo os marcadores clavitor://Entry/field em trânsito, de modo que o agente nunca detém a credencial real. Consulte a página do proxy para saber o que protege e como.
O guia é escrito de forma conversacional para que um humano ou um agente de IA possa lê-lo de cima a baixo e executá-lo em uma máquina real. Escolha seu sistema operacional abaixo — cada seção é um procedimento autônomo de seis passos.
Antes de começar: obtenha um blob de inscrição e a chave no cofre
Precisa de um blob de inscrição e da respetiva chave de inscrição do seu cofre. Esta é a única parte que só um humano pode fazer — o cofre exige um toque no hardware para autorizar um novo agente.
Na interface web do cofre, aceda a Clientes → + Novo cliente, dê um nome ao cliente (por exemplo, "Proxy Local"), escolha a que entradas ele pode aceder e toque na sua chave de segurança quando solicitado. O Clavitor devolve um blob de inscrição e uma chave de inscrição. Copie ambos. Os passos abaixo pedem-lhe que cole cada um uma vez e depois se esqueça deles.
Linux
O guia abaixo usa bash e assume que você está em x86-64; substitua arm64 por amd64 se você estiver em aarch64.
1. Baixe o binário do proxy e torne-o executável. Um único binário autônomo, sem dependências:
$ curl -LO https://clavitor.ai/downloads/clavitor-proxy-linux-amd64 $ chmod +x clavitor-proxy-linux-amd64
2. O binário está em disco. Agora ligue-o ao seu cofre. O proxy lê o blob e a chave a partir do stdin (nunca da linha de comandos, para não ficarem no histórico da shell). Cole cada um a partir de "Antes de começar" quando lhe for pedido (a chave não é ecoada) e confirme o anfitrião do cofre que lhe é mostrado:
$ ./clavitor-proxy-linux-amd64 init
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>
This token enrolls the agent against vault:
<vault-host>
Your key authenticated the blob — NOT this host. If you did not get
this blob from your own vault operator, answering yes hands your
agent's credential resolution to whoever did.
Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config /path/to/clavitor.conf
Try: clavitor-proxy ca > ca.pem then clavitor-proxy serveO que acabou de acontecer: o blob foi desencriptado localmente com a chave (sem chamada de rede), e o endereço do cofre + a identidade do agente + a chave de Criptografia de credenciais foram gravados num ficheiro encriptado, clavitor.conf, junto ao binário (modo 0600). Não precisa novamente do blob nem da chave. Quando a entrada é enviada por pipe em vez de digitada, a confirmação do host não pode ser respondida, por isso defina primeiro CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host>.
3. Exporte a CA raiz do proxy. O proxy irá terminar todas as conexões HTTPS que seu agente fizer e emitir um certificado para cada host upstream em tempo real. Sem confiar em sua CA raiz, esses certificados falhariam na verificação:
$ ./clavitor-proxy-linux-amd64 ca > clavitor-proxy-ca.pem
4. Instale a CA no armazenamento de confiança do sistema. Em Debian/Ubuntu e derivados:
$ sudo cp clavitor-proxy-ca.pem /usr/local/share/ca-certificates/clavitor-proxy-ca.crt $ sudo update-ca-certificates
update-ca-certificates deve exibir 1 added. A partir de agora, todos os clientes HTTPS na máquina (curl, requests do Python, net/http do Go, etc.) aceitam os certificados do proxy como legítimos.
5. Inicie o proxy. Ele se vincula a 127.0.0.1:1983 e é executado em primeiro plano; Ctrl-C o para:
$ ./clavitor-proxy-linux-amd64 serve clavitor-proxy <version> listening on 127.0.0.1:1983 Point your agent at: HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983 Token redacted above; it is stored 0600 at /path/to/proxy-auth. e.g. export HTTPS_PROXY="http://clavitor:$(cat /path/to/proxy-auth)@127.0.0.1:1983"
Para uma configuração permanente, crie uma unidade systemd que aponte para o mesmo binário, para que esta seja reiniciada após um reinício do sistema.
6. Aponte o agente para o proxy e verifique de ponta a ponta. Noutra shell, na pasta que contém o binário (o ficheiro proxy-auth aí é o token de acesso do proxy; serve imprime esta linha):
$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983" $ curl -H "Authorization: Bearer clavitor://OpenAI/key" https://api.openai.com/v1/models
O que realmente sai do proxy e chega aos servidores da OpenAI — a requisição que seu agente nunca vê:
GET /v1/models HTTP/1.1 Host: api.openai.com Authorization: Bearer sk-proj-abc123def456ghi789… ← real key, injected by the proxy User-Agent: curl/8.4.0
Se receber uma resposta JSON do OpenAI, está tudo ligado. O proxy resolveu clavitor://OpenAI/key no cofre usando a chave de Criptografia de credenciais do passo 2, substituiu a chave real no cabeçalho Authorization e encaminhou o pedido para a origem. O código do seu agente guarda apenas o placeholder; a chave real nunca sai da memória do processo do proxy.
macOS
O guia abaixo usa zsh (o shell padrão no macOS) e assume Apple Silicon; substitua amd64 por arm64 se você estiver em um Mac Intel.
1. Transfira o proxy e descompacte-o. O arquivo contém uma pasta: o programa e as duas bibliotecas do seu módulo criptográfico FIPS, que ficam ao lado dele:
$ curl -LO https://clavitor.ai/downloads/clavitor-proxy-darwin-arm64.tar.gz $ tar -xzf clavitor-proxy-darwin-arm64.tar.gz $ cd clavitor-proxy-darwin-arm64
Se o Gatekeeper do macOS se recusar a executar o binário pela primeira vez, clique com o botão direito nele no Finder, escolha Abrir e confirme — isso registra a exceção. Depois disso, a invocação pela linha de comando funciona.
2. O binário está em disco. Agora ligue-o ao seu cofre. O proxy lê o blob e a chave a partir do stdin (nunca da linha de comandos, para não ficarem no histórico da shell). Cole cada um a partir de "Antes de começar" quando lhe for pedido (a chave não é ecoada) e confirme o anfitrião do cofre que lhe é mostrado:
$ ./clavitor-proxyinit
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>
This token enrolls the agent against vault:
<vault-host>
Your key authenticated the blob — NOT this host. If you did not get
this blob from your own vault operator, answering yes hands your
agent's credential resolution to whoever did.
Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config /path/to/clavitor.conf
Try: clavitor-proxy ca > ca.pem then clavitor-proxy serveO que acabou de acontecer: o blob foi desencriptado localmente com a chave (sem chamada de rede), e o endereço do cofre + a identidade do agente + a chave de Criptografia de credenciais foram gravados num ficheiro encriptado, clavitor.conf, junto ao binário (modo 0600). Não precisa novamente do blob nem da chave. Quando a entrada é enviada por pipe em vez de digitada, a confirmação do host não pode ser respondida, por isso defina primeiro CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host>.
3. Exporte a CA raiz do proxy. O proxy irá terminar todas as conexões HTTPS que seu agente fizer e emitir um certificado para cada host upstream em tempo real. Sem confiar em sua CA raiz, esses certificados falhariam na verificação:
$ ./clavitor-proxyca > clavitor-proxy-ca.pem
4. Instale a CA no System Keychain. Um comando, pede sua senha sudo:
$ sudo security add-trusted-cert -d -r trustRoot \
-k /Library/Keychains/System.keychain clavitor-proxy-ca.pemApós isso, Safari, curl, Swift, Python, Go e a maioria dos outros clientes HTTPS na máquina aceitam os certificados do proxy. (Um pequeno número de runtimes de linguagem envia seu próprio pacote de confiança e precisa de configuração separada — você verá um erro de certificado se for o caso.)
5. Inicie o proxy. Ele se vincula a 127.0.0.1:1983 e é executado em primeiro plano; Ctrl-C o para:
$ ./clavitor-proxyserve clavitor-proxy <version> listening on 127.0.0.1:1983 Point your agent at: HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983 Token redacted above; it is stored 0600 at /path/to/proxy-auth. e.g. export HTTPS_PROXY="http://clavitor:$(cat /path/to/proxy-auth)@127.0.0.1:1983"
Para uma configuração permanente, instale-o como um agente launchd para que ele inicie no login e reinicie em caso de falha.
6. Aponte o agente para o proxy e verifique de ponta a ponta. Noutra shell, na pasta que contém o binário (o ficheiro proxy-auth aí é o token de acesso do proxy; serve imprime esta linha):
$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983" $ curl -H "Authorization: Bearer clavitor://OpenAI/key" https://api.openai.com/v1/models
O que realmente sai do proxy e chega aos servidores da OpenAI — a requisição que seu agente nunca vê:
GET /v1/models HTTP/1.1 Host: api.openai.com Authorization: Bearer sk-proj-abc123def456ghi789… ← real key, injected by the proxy User-Agent: curl/8.4.0
Se receber uma resposta JSON do OpenAI, está tudo ligado. O proxy resolveu clavitor://OpenAI/key no cofre usando a chave de Criptografia de credenciais do passo 2, substituiu a chave real no cabeçalho Authorization e encaminhou o pedido para a origem. O código do seu agente guarda apenas o placeholder; a chave real nunca sai da memória do processo do proxy.
Windows
O guia abaixo usa o PowerShell no Windows de 64 bits.
1. Transfira o proxy e descompacte-o. O zip contém uma pasta: clavitor-proxy.exe e as duas bibliotecas do seu módulo criptográfico FIPS, que ficam ao lado dele:
> Invoke-WebRequest https://clavitor.ai/downloads/clavitor-proxy-windows-amd64.zip `
-OutFile clavitor-proxy.zip
> Expand-Archive clavitor-proxy.zip .
> cd clavitor-proxy-windows-amd64O Windows SmartScreen pode exibir um aviso na primeira vez que você executa um binário não assinado — clique em Mais informações → Executar mesmo assim para permiti-lo.
2. O binário está em disco. Agora ligue-o ao seu cofre. O proxy lê o blob e a chave a partir do stdin (nunca da linha de comandos, para não ficarem no histórico do PowerShell). Cole cada um a partir de "Antes de começar" quando lhe for pedido (a chave não é ecoada) e confirme o anfitrião do cofre que lhe é mostrado:
> .\clavitor-proxy.exe init
Paste enrollment blob, then press Enter:
<paste-the-blob-here>
Enrollment key:
<paste-the-key-here>
This token enrolls the agent against vault:
<vault-host>
Your key authenticated the blob — NOT this host. If you did not get
this blob from your own vault operator, answering yes hands your
agent's credential resolution to whoever did.
Enroll against <vault-host>? [yes/no] yes
Enrolled against vault https://<vault-host>
Vault ID <vault-id>
Config C:\path\to\clavitor.conf
Try: clavitor-proxy ca > ca.pem then clavitor-proxy serveO que acabou de acontecer: o blob foi desencriptado localmente com a chave (sem chamada de rede), e o endereço do cofre + a identidade do agente + a chave de Criptografia de credenciais foram gravados num ficheiro encriptado, clavitor.conf, junto ao binário. Não precisa novamente do blob nem da chave. Quando a entrada é enviada por pipe em vez de digitada, a confirmação do host não pode ser respondida, por isso defina primeiro CLAVITOR_PROXY_CONFIRM_VAULT=<vault-host>.
3. Exporte a CA raiz do proxy. O proxy irá terminar todas as conexões HTTPS que seu agente fizer e emitir um certificado para cada host upstream em tempo real. Sem confiar em sua CA raiz, esses certificados falhariam na verificação:
> .\clavitor-proxy.exe ca > clavitor-proxy-ca.pem
4. Instale a CA no armazenamento de Raiz Confiável da Máquina Local. Abra um PowerShell elevado (Clique com o botão direito no PowerShell → Executar como administrador) e execute:
> certutil -addstore -f "ROOT" clavitor-proxy-ca.pem
Após isso, Edge, .NET, curl.exe e a maioria dos clientes HTTP na máquina aceitam os certificados do proxy. (O Firefox mantém seu próprio armazenamento de confiança; se você estiver testando através do Firefox, importe a CA separadamente em Configurações → Privacidade e Segurança → Certificados → Ver Certificados → Autoridades → Importar.)
5. Inicie o proxy. Ele se vincula a 127.0.0.1:1983 e é executado em primeiro plano; Ctrl-C o para:
> .\clavitor-proxy.exe serve clavitor-proxy <version> listening on 127.0.0.1:1983 Point your agent at: HTTPS_PROXY=http://clavitor:<token>@127.0.0.1:1983 Token redacted above; it is stored 0600 at C:\path\to\proxy-auth. e.g. export HTTPS_PROXY="http://clavitor:$(cat C:\path\to\proxy-auth)@127.0.0.1:1983"
Para uma configuração permanente, registre-o como um serviço do Windows ou tarefa agendada para que ele inicie na inicialização.
6. Aponte o agente para o proxy e verifique de ponta a ponta. Noutra janela do PowerShell, na pasta que contém o binário (o ficheiro proxy-auth aí é o token de acesso do proxy):
> $env:HTTPS_PROXY = "http://clavitor:$(Get-Content proxy-auth)@127.0.0.1:1983"
> curl.exe -H "Authorization: Bearer clavitor://OpenAI/key" `
https://api.openai.com/v1/models(Use curl.exe explicitamente — o alias curl do PowerShell aponta para Invoke-WebRequest, que lida com a variável de ambiente do proxy de forma diferente.) O que realmente sai do proxy e chega aos servidores da OpenAI — a requisição que seu agente nunca vê:
GET /v1/models HTTP/1.1 Host: api.openai.com Authorization: Bearer sk-proj-abc123def456ghi789… ← real key, injected by the proxy User-Agent: curl/8.4.0
Se receber uma resposta JSON do OpenAI, está tudo ligado. O proxy resolveu clavitor://OpenAI/key no cofre usando a chave de Criptografia de credenciais do passo 2, substituiu a chave real no cabeçalho Authorization e encaminhou o pedido para a origem. O código do seu agente guarda apenas o placeholder; a chave real nunca sai da memória do processo do proxy.
Instale a skill Claude Code
O CLI vem com uma definição de skill integrada que ensina o Claude Code a usar seu cofre. Um comando a instala.
# Install globally (all projects) $ clavitor-cli skill > ~/.claude/skills/clavitor.md # Or install for a specific project $ clavitor-cli skill > /path/to/project/.claude/skills/clavitor.md
A skill está embutida no binário. Atualize-a baixando uma nova versão.
Use-a
O seu agente pode agora obter credenciais e guardar novos segredos. Cada acesso é registado no registo de auditoria do cofre.
# Fetch a credential $ clavitor-cli get github # Store a new credential (secrets come from a file or stdin, never the command line) $ clavitor-cli put credential "AWS Prod" --username admin --password-file pw.txt # Find entries by name (titles only, never the vault's full list) $ clavitor-cli find "AWS"
Uma chamada CLI. Todos os segredos.
O seu cofre, os seus âmbitos, o seu registo de auditoria. Sem segredos em ficheiros env ou de configuração, nenhum em registos.