⚙️Configurações e chaves

Tudo é configurável em Configurações; não é preciso editar nenhum arquivo.

Alterar o fuso horário aqui não muda o relógio do servidor: execute também timedatectl set-timezone <Zone> && systemctl restart cron para que as tarefas agendadas o sigam (veja Crons).

Instalar o app

O Harness Maxxing se instala como um app (janela própria, um ícone no Dock, na barra de tarefas ou na tela inicial, tela cheia no celular). Dois lugares: Instalar app no menu da conta (o ícone de pessoa na parte de baixo da barra lateral; no celular, no menu ⊞) e Configurações -> Geral -> App.

• Chrome, Edge (computador ou Android): um clique quando o navegador oferece; caso contrário, o botão mostra os passos (o ícone de instalação no fim da barra de endereços, ou o menu do navegador).
• Safari no Mac (macOS 14 ou posterior): Arquivo -> Adicionar ao Dock.
• iPhone / iPad: botão Compartilhar do Safari -> Adicionar à Tela de Início.
• O Firefox não consegue instalar apps web no computador: use Chrome, Edge ou Safari.
• O cartão do App mostra um QR code do endereço: escaneie com o celular, faça login e depois adicione à tela inicial.
• A instalação exige o endereço https (acesso por domínio). Pelo Tailscale (http://100.x.y.z:8787) os navegadores não a oferecem.

Em um celular ou tablet

Celulares e tablets recebem o layout por toque (Configurações -> Geral -> Layout o altera por dispositivo): sem barra lateral, sem barra na parte de baixo, a conversa ocupa a tela toda. Dois botões ficam no topo de cada tela: - ☰ (canto superior esquerdo) abre suas sessões - veja Sessões. O contador mostra as respostas não lidas. - ⊞ (canto superior direito) abre todo o resto: um campo de busca (o mesmo do ⌘K), todas as páginas (Dashboard, Sessões, Arquivos, Tarefas, Crons, Notificações, Git e Infra quando ativados, Extensões e páginas fixadas), a atualização pendente, a saúde do servidor, o uso do seu plano Claude, o tema, o modo de apresentação, Configurações, Ajuda (tour, tutorial, docs) e Sair. Um ponto no ⊞ indica que há uma atualização pendente ou que o servidor precisa de atenção.

Além disso: - No app instalado, deslize a partir da borda esquerda para abrir as sessões e a partir da borda direita para abrir o menu; deslize a gaveta de volta em direção à borda para fechá-la. - Os painéis que sobem a partir da parte de baixo se fecham com um deslize para baixo (a partir da alça, do título ou do conteúdo quando ele está rolado até o topo), ou com um toque na área escurecida acima deles. - Os botões de microfone e de envio são maiores; enquanto você digita, os painéis ficam acima do teclado. - A página não dá zoom (sem pinça, sem toque duplo), como um app nativo; os campos nunca fazem o iPhone dar zoom.

Autenticação do Claude

Três formas, da melhor para a menos indicada: 1. Token de longa duração: execute claude setup-token em qualquer computador com navegador e cole o token. 2. Chave de API do console da Anthropic (cobrada por uso). 3. Login pela CLI feito no servidor (claude, depois /login): detectado automaticamente.

Testar faz uma chamada real de uma linha e mostra o modelo e a latência.

Os turnos iniciam o Claude sem a verificação de atualização, a telemetria e o download de feature flags (início mais rápido, prompt mais curto); "claude_quiet_start": false no config.json desativa isso.

O Claude executa seus agentes auxiliares em primeiro plano: você recebe o resultado no mesmo turno (vários agentes ainda rodam lado a lado). O hábito do próprio Claude Code é enviá-los para segundo plano, onde o turno espera que eles respondam, o que é mais lento; "background_agents": true no config.json volta a esse comportamento. Você sempre pode pedir ao Claude um agente em segundo plano na sua mensagem.

Atualizações do Claude Code

Atualizar o Claude Code automaticamente (desativado por padrão): a cada 6 horas o servidor procura uma versão estável mais nova do Claude Code (a que a Anthropic marca como estável: já usada por alguns dias, não a mais recente). Quando há uma, ele mesmo instala essa versão - mas só quando nada está em execução: nenhum turno de conversa, nenhuma mensagem esperando em uma fila, nenhuma tarefa agendada, e o último turno terminou há mais de 10 minutos. Caso contrário, ele espera e tenta de novo alguns minutos depois, de modo que uma atualização nunca interrompe um turno, e um turno que começa durante a atualização espera por ela (a conversa avisa; no máximo 7 minutos). Só o servidor instalado faz isso: um segundo Harness Maxxing iniciado na mesma máquina para desenvolvimento ou testes nunca atualiza o Claude Code da máquina. Funciona com o instalador oficial e com uma instalação global via npm (outro tipo de instalação é deixado de lado). Se a nova versão não iniciar, a anterior é restaurada.

Cada atualização aparece nas notificações ("Claude Code atualizado para 2.1.5"), e o interruptor mostra a última (2.1.4 -> 2.1.5 e sua data). Uma falha também é notificada, uma vez por versão, com o motivo; o servidor tenta de novo 6 horas depois. Deixe o interruptor desativado para atualizar manualmente (claude update em um terminal); maxxing doctor então lista o Claude Code em claude_version quando ele está desatualizado.

Modo de permissão

Um tópico pode ter seu próprio modo (lista de sessões -> menu do tópico -> Permissões), e uma tarefa agendada do Claude também (Modo de permissão no editor da tarefa): use um modo mais restrito onde o Claude lê conteúdo externo - páginas web, e-mails, mensagens encaminhadas - para que instruções escondidas nesse conteúdo não o façam executar qualquer coisa. Ordem: o modo da tarefa, senão o do tópico, senão este modo global.

Proteger os segredos (ativado por padrão): em todos os modos, as ferramentas do Claude se recusam a ler ou editar os segredos do servidor (secrets.json) e as chaves SSH (~/.ssh). Isso impede que uma instrução escondida simplesmente os leia; um script escrito de propósito para abrir o arquivo não é impedido, então isso não substitui um modo mais restrito. Mais regras: claude_deny no config.json (sintaxe de regras do Claude Code, por exemplo "Bash(rm -rf:*)").

Veja Segurança.

Chaves (cofre de segredos)

Guarde as chaves de API e tokens de que seus projetos precisam (por exemplo OPENAI_API_KEY, SHOP_TOKEN):

• os nomes são em MAIÚSCULAS (A-Z, dígitos, _), os valores ficam ocultos e só aparecem ao clicar em Revelar;
• adicione uma nota (para que serve, de onde vem);
• Expor disponibiliza o segredo como variável de ambiente para toda sessão do Claude e toda tarefa cron de shell – útil para scripts, e o Claude nunca precisa ver o valor em uma conversa;
• alguns nomes são reservados (variáveis do sistema, variáveis que fazem shells, Node, Python ou git carregarem código - NODE_OPTIONS, BASH_ENV, GIT_SSH_COMMAND... -, ANTHROPIC_BASE_URL, qualquer nome que comece com MAXXING_); uma chave existente com esse tipo de nome é mantida, mas deixa de ser exposta.

A partir de scripts e sessões: maxxing keys list|get|set|delete (o valor de set é lido da entrada padrão) - um script que renova um token grava o novo valor de volta dessa forma. Os scripts leem as chaves do ambiente (os.environ["NAME"]), nunca de um arquivo próprio.

Escreva apenas o nome da chave nos arquivos de memória ("API da loja: chave SHOP_TOKEN"). As extensões leem as chaves com ctx["secret"]("NAME").

As chaves ficam em /var/lib/claude-maxxing/secrets.json (modo 600) e não são incluídas no backup.