# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
 
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Homebrew (macOS)
brew install --cask claude-code
 
# WinGet (Windows)
winget install Anthropic.ClaudeCode

# Login com sua conta Anthropic
claude login
 
# Ou definir a chave API diretamente
export ANTHROPIC_API_KEY="sua-chave-api"

# Navegue até seu projeto
cd seu-projeto
 
# Inicialize o AIOS
npx @anthropic/aios init
 
# Selecione "Claude Code" quando solicitado para IDE

# Verificar tipo de instalação e versão
claude doctor
 
# Verificar se os arquivos AIOS foram criados
ls -la .claude/

.claude/
├── commands/
│   └── AIOS/
│       └── agents/        # Agentes sincronizados
├── settings.json          # Configurações locais
└── settings.local.json    # Sobrescritas locais

~/.claude/                 # Diretório de config global
~/.claude.json             # Configuração MCP global

# Obrigatório
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Opcional
export CLAUDE_MODEL="claude-sonnet-4-20250514"  # Modelo padrão
export CLAUDE_MAX_TOKENS="8192"                 # Máximo de tokens de resposta
export AIOS_DEBUG="true"                        # Habilitar log de debug

{
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 8192,
  "permissions": {
    "allowedTools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
    "blockedCommands": ["rm -rf /", "sudo rm"]
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/caminho/permitido"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

# Iniciar no diretório atual
claude
 
# Iniciar com contexto específico
claude --context "Trabalhando na feature X"
 
# Iniciar com um arquivo específico
claude --file src/main.ts

/dev         # Agente Desenvolvedor
/qa          # Agente Engenheiro de QA
/architect   # Agente Arquiteto de Software
/pm          # Agente Gerente de Projeto
/po          # Agente Product Owner
/sm          # Agente Scrum Master
/analyst     # Agente Analista de Negócios
/devops      # Agente Engenheiro DevOps

/nome-agente [descrição da tarefa]

# Exemplos
/dev implemente a feature de login seguindo a story
/qa revise o módulo de autenticação para problemas de segurança
/architect projete o schema do banco de dados para gerenciamento de usuários

1. /pm para revisar os requisitos da story
2. /architect para projetar a solução
3. /dev para implementar a feature
4. /qa para testar a implementação
5. /dev para corrigir quaisquer problemas

1. /qa revise este PR para melhores práticas
2. /dev enderece os comentários da revisão

1. /analyst investigue o relatório de bug
2. /dev reproduza e corrija o problema
3. /qa verifique a correção

# Via agente DevOps
/devops
*add-mcp playwright

# Criação automática de subagente
/dev implemente esta feature

# O Claude pode criar:
# - Agente Explore para análise de codebase
# - Agente Plan para decisões de arquitetura
# - Agente Bash para execução de comandos

// .claude/hooks/pre-commit.js
module.exports = {
  name: 'pre-commit',
  trigger: 'before:commit',
  execute: async (context) => {
    // Executar linting antes do commit
    await context.bash('npm run lint');
    await context.bash('npm test');
  }
};

 
# Skill de Deploy
 
## Descrição
Fazer deploy da aplicação para produção
 
## Passos
1. Executar testes
2. Buildar a aplicação
3. Deploy para o servidor
 
## Comandos
```bash
npm test
npm run build
npm run deploy

### Memória e Contexto

O Claude Code mantém memória de sessão:

---

## Recursos Específicos do Claude Code

### Acesso Nativo a Ferramentas

| Ferramenta | Descrição | Exemplo |
|------------|-----------|---------|
| `Read` | Ler arquivos | Ler arquivos inteiros ou linhas específicas |
| `Write` | Criar arquivos | Escrever novos arquivos com conteúdo |
| `Edit` | Modificar arquivos | Encontrar e substituir texto |
| `Bash` | Executar comandos | Executar comandos shell |
| `Glob` | Encontrar arquivos | Correspondência de padrão para arquivos |
| `Grep` | Buscar conteúdo | Busca regex em arquivos |
| `Task` | Criar agentes | Operações complexas de múltiplas etapas |
| `WebFetch` | Requisições HTTP | Buscar conteúdo web |
| `WebSearch` | Buscar na web | Obter informações atuais |

### Atalhos de Teclado

| Atalho | Ação |
|--------|------|
| `Ctrl+C` | Cancelar operação atual |
| `Ctrl+D` | Sair do Claude Code |
| `Ctrl+L` | Limpar tela |
| `Cima/Baixo` | Navegar histórico |

### Linha de Status

O Claude Code mostra status em tempo real:

---

## Sincronização de Agentes

### Como Funciona

```mermaid
flowchart LR
    Source["AIOS Core / .aios-core/development/agents"] --> Parser["Parser de Agente"]
    Parser --> Transform["Transformador Claude"]
    Transform --> Output[".claude/commands/AIOS/agents"]

# Sincronizar todos os agentes
npm run sync:ide
 
# Sincronizar agente específico
npm run sync:ide
 
# Forçar ressincronização
npm run sync:ide

---
name: dev
displayName: Desenvolvedor
description: Desenvolvedor Full Stack Sênior
activation: /dev
---
 
# Agente Desenvolvedor
 
## Expertise
- TypeScript/JavaScript
- Node.js
- React
- Design de banco de dados
 
## Fluxo de Trabalho
1. Entender requisitos
2. Planejar implementação
3. Escrever código limpo
4. Testar completamente

Error: Authentication failed

# Re-autenticar
claude logout
claude login
 
# Ou verificar chave API
echo $ANTHROPIC_API_KEY

Error: MCP server 'xyz' not found

# Listar servidores MCP disponíveis
/devops
*list-mcps
 
# Instalar servidor faltante
*add-mcp xyz

Error: Unknown command '/xyz'

# Ressincronizar agentes
npm run sync:ide
 
# Verificar se o agente existe
ls .claude/commands/AIOS/agents/

Error: Permission denied for tool 'Bash'

{
  "permissions": {
    "allowedTools": ["Bash"]
  }
}

# Habilitar modo debug
export AIOS_DEBUG=true
 
# Ver logs do Claude Code
cat ~/.claude/logs/latest.log
 
# Verificar logs do AIOS
cat .aios-core/logs/sync.log

# Resetar configurações do Claude Code
rm -rf ~/.claude/
 
# Reinicializar
claude login