Skip to content

CLI ​

text
claude-vps <command> [options]
ComandoOndeO que faz
setupservidor, como rootRoda as etapas de instalação
updateservidor, como rootBaixa a versão mais recente e roda o setup de novo com as opções da primeira instalação
syncservidorgit pull e depois apply
autosync on|offservidorTimer do systemd do usuário que roda o sync a cada 30 minutos
doctorservidorConfere Claude, tmux, Docker, xrdp, Plasma, ufw, ntfy e autosync
captureseu computadorCopia os arquivos de dotfiles/manifest.txt para dotfiles/home
publishseu computadorcapture, commit e push
release X.Y.Zseu computadorGrava o VERSION, cria a tag vX.Y.Z e faz push. O GitHub publica a release a partir do CHANGELOG.md
applyqualquer lugarCopia dotfiles/home para $HOME e guarda cópia do que substitui
versionqualquer lugarMostra a versão

setup ​

bash
sudo claude-vps setup [options]
OpçãoPadrão
-u, --user NAME$SUDO_USER, ou perguntaO seu usuário. É criado se não existir
--rdp-port PORT53389Porta do xrdp
--rdp-privatedesligadoNão abre a porta do RDP no ufw
--ntfy-topic NAMEperguntaTópico do ntfy.sh para as notificações
--timezone TZsem mudançaPor exemplo Europe/Istanbul
--no-desktopdesligadoO mesmo que --skip desktop,rdp
--skip a,bEtapas a pular
--only a,bRoda só estas etapas
-y, --yesdesligadoSem perguntas. O usuário vira dev e a senha é gerada
-n, --dry-rundesligadoMostra os comandos sem rodar

Etapas, em ordem: base user ssh firewall desktop rdp apps claude dotfiles.

Atualizar ​

Quando sair uma versão nova, rode isto em cada servidor:

bash
sudo claude-vps update

O comando baixa o código novo, mostra o que mudou e roda de novo todas as etapas do setup. Etapas que já foram feitas são puladas. O xrdp e o SSH só reiniciam se a configuração deles mudou, então uma sessão RDP aberta continua conectada. As opções que você escolheu na primeira instalação (usuário, porta RDP, etapas puladas) ficam em /etc/claude-vps.conf e são usadas de novo.

O claude-vps sync também avisa quando chega uma versão nova.

Publicar uma versão ​

No seu computador, adicione uma seção ## X.Y.Z ao CHANGELOG.md, faça o commit e depois rode:

bash
claude-vps release X.Y.Z

O workflow de release confere se a tag bate com o VERSION e publica uma release no GitHub. As notas da release são essa seção do changelog.

Máquinas de origem da configuração ​

O claude-vps capture marca a máquina onde roda como origem da configuração (~/.config/claude-vps/source). Nessa máquina, apply e sync não mexem nos seus arquivos, porque a cópia do repo pode ser mais antiga do que a que você está usando. Para sobrescrever mesmo assim, use claude-vps apply --force.

install.sh ​

O script de instalação lê três variáveis de ambiente:

VariávelPadrão
CLAUDE_VPS_REPOhttps://github.com/halitsever/claude-code-vps.git
CLAUDE_VPS_DIR/opt/claude-vps
CLAUDE_VPS_BRANCHmain

Tudo o que vier depois de bash -s -- é passado para o setup.

MIT licensed. Not affiliated with Anthropic.