Implant Documentação 8de3f8d

implant setup-claude-code

Configura um usuario dedicado claudecode para execucao segura do Claude Code.

Uso 

implant setup-claude-code [OPTIONS]

Flags

Flag Descricao Padrao
--unrestricted Concede sudo completo (NOPASSWD: ALL) —
--workdir <DIR> Diretorio de trabalho com acesso ACL /srv/apps
--guardrail-url <URL> URL base do guard-rail remoto (somente https://) endpoints.guardrail_base do config.toml (https://implant.ccs.systems/claudecode/)
--no-auto-update Nao instala o cron de atualizacao automatica do guard-rail —
--dry-run Simular sem aplicar (flag global) —
--verbose Saida detalhada (flag global) —

O que configura

1. Usuario e Grupo

  • Cria usuario claudecode com home em /home/claudecode
  • Cria grupo claudecode
  • Shell: /bin/bash

2. Docker

  • Adiciona claudecode ao grupo docker

3. Sudoers

Modo granular (padrao):

  • systemctl (status, restart, start, stop, reload, enable, disable)
  • journalctl
  • ss, netstat, iptables (leitura)
  • apt/apt-get (update, install)
  • Docker e Docker Compose
  • Logs (tail, cat, less em /var/log/)
  • Traefik/Nginx configs (tee, cat em /etc/)

Modo irrestrito (--unrestricted):

  • NOPASSWD: ALL - sudo completo sem senha
  • Usar apenas em servidores de desenvolvimento isolados

4. Limites de Recursos 

claudecode  soft  nproc   4096
claudecode  hard  nproc   8192
claudecode  soft  nofile  65536
claudecode  hard  nofile  65536
claudecode  hard  as      8388608

5. ACLs

  • Configura ACLs no diretorio de trabalho (padrao: /srv/apps)
  • claudecode tem leitura/escrita/execucao
  • ACLs default para novos arquivos

6. Ambiente

  • Git configurado (user.name, user.email)
  • Diretorio .claude criado

7. Guard-rail

  • Baixa CLAUDE.md da URL base do guard-rail (padrao: https://implant.ccs.systems/claudecode/)
  • Instala em /home/claudecode/.claude/CLAUDE.md
  • Se falhar, cria guard-rail padrao
  • Download protegido por TLS pinning

8. Auto-update (cron)

  • Cron a cada 6 horas: implant update-guardrail --quiet

Exemplos

Setup padrao (granular) 

implant setup-claude-code

Setup para desenvolvimento (irrestrito) 

implant setup-claude-code --unrestricted

Diretorio de trabalho customizado 

implant setup-claude-code --workdir /opt/projetos

Usar como claudecode 

sudo -iu claudecode
claude

Comando Relacionado

update-guardrail

Atualiza o guard-rail CLAUDE.md manualmente:

implant update-guardrail
implant update-guardrail --force
implant update-guardrail --status

Ver update-guardrail para documentacao completa.