cerebro-vip INEMA.CLUB
início › INEMA.DEV Desenvolvimento

Guia prático do BMAD Method explicando como usá-lo em diferentes…

INEMA.DEV Desenvolvimento · 2025-10-15 · ~5 min · ver no Telegram ↗

INEMA

bing.com ↗

inematds.github.io/BMAD-Academy ↗

github.com/inematds/BMAD-Academy ↗

Se você estiver usando o Codex (CLI da OpenAI), o comportamento é bem parecido — mas com algumas diferenças importantes na forma como ele lê e usa as APIs.

Aqui está o fluxo prático de onde o BMad busca e como ele funciona dentro do Codex:

1. Execução Local (mesmo ambiente do Node.js)⌗

  • O Codex CLI também roda comandos locais, como:

npx bmad-method status npx bmad-method add project "app de exemplo" * Ele usa o mesmo Node.js local e, portanto, o mesmo .env do projeto.

2. Fonte da API⌗

O Codex vai procurar a chave da API em três locais possíveis, nesta ordem:

  1. Variáveis do ambiente do sistema (ENV do sistema operacional) Exemplo (Windows):

setx OPENAI_API_KEY "sk-xxxx"

ou (Linux/macOS):

export OPENAI_API_KEY="sk-xxxx"

  1. Arquivo .env do projeto (na pasta raiz)

OPENAI_API_KEY=sk-xxxx ANTHROPIC_API_KEY=sk-xxxx

  1. Configuração direta no bmad-config.json (opcional)

{ "default_model": "gpt-4o", "agents": { "dev": "gpt-4o", "pm": "claude-3.5-sonnet" } }

3. Onde o Codex “fala” com a API⌗

  • Todas as chamadas são feitas via HTTPS do seu computador, ou seja:

  • Se usar OpenAI → https://api.openai.com/v1/...

  • Se usar Anthropic → https://api.anthropic.com/v1/...
  • Se usar Gemini → https://generativelanguage.googleapis.com/...
  • O Codex não faz proxy: ele apenas executa o comando que chama o endpoint da LLM diretamente.

4. O que muda em relação ao Claude Code⌗

Ambiente Onde executa Onde lê API Observação
Claude Code Terminal integrado na IDE .env local Pode ter suporte a várias LLMs no mesmo workspace
Codex CLI Terminal do sistema (cmd, bash, zsh) .env ou variáveis do sistema Execução pura via Node.js
Make/n8n Fluxos automatizados Chaves armazenadas no módulo Execução em nuvem, sem .env local

5. Conclusão⌗

Se você rodar o BMad dentro do Codex CLI, ele:

  • Busca as chaves no .env (ou variáveis do sistema)
  • Faz as chamadas diretas às APIs configuradas
  • Usa o mesmo fluxo do BMad normal (sem precisar do Claude)
  • Pode misturar agentes com diferentes LLMs, conforme o bmad-config.json
  1. Abrir o Codex
  2. Abrir o terminal integrado
  3. Navegar até o diretório do projeto
  4. Executar npx bmad-method status
  5. Executar npx bmad-method list:agents
  6. Executar npx bmad-method add project "nome do projeto"
  7. Executar As analyst, defina os requisitos do projeto
  8. Executar As pm, crie o plano e escopo do projeto
  9. Executar As architect, defina a estrutura e componentes
  10. Executar As ux-expert, desenhe a interface
  11. Executar As dev, desenvolva o código do projeto
  12. Executar As qa, valide e teste o resultado
  13. Executar npx bmad-method save
  14. Executar npx bmad-method log
  15. Visualizar resultados em /projects/<nome do projeto>/

  16. (Opcional) Executar /bmad-master auto para modo automático

  17. Abrir o Claude Code

  18. Abrir o terminal integrado (aba “Terminal”)
  19. Navegar até o diretório do projeto
  20. Executar npx bmad-method status
  21. Executar npx bmad-method list:agents
  22. Executar npx bmad-method add project "nome do projeto"
  23. Executar As analyst, defina os requisitos do projeto
  24. Executar As pm, crie o plano e escopo do projeto
  25. Executar As architect, defina a estrutura e componentes
  26. Executar As ux-expert, desenhe a interface
  27. Executar As dev, desenvolva o código do projeto
  28. Executar As qa, valide e teste o resultado
  29. Executar npx bmad-method save
  30. Executar npx bmad-method log
  31. Visualizar resultados em /projects/<nome do projeto>/

  32. (Opcional) Executar /bmad-master auto para modo automático

  33. Abrir o terminal ou console da IDE

  34. Navegar até o diretório do projeto
  35. Executar npx bmad-method status
  36. Executar npx bmad-method list:agents
  37. Executar npx bmad-method add project "nome do projeto"
  38. Executar As analyst, defina os requisitos do projeto
  39. Executar As pm, crie o plano e escopo do projeto
  40. Executar As architect, defina a estrutura e componentes
  41. Executar As ux-expert, desenhe a interface
  42. Executar As dev, desenvolva o código do projeto
  43. Executar As qa, valide e teste o resultado
  44. Executar npx bmad-method save
  45. Executar npx bmad-method log
  46. Verificar saída em /projects/<nome do projeto>/
  47. Opcional: Executar /bmad-master auto para modo automático

Nos casos (terminal e Claude Code, Codex, Cursor), o BMad busca a API da LLM configurada no seu arquivo .env ou bmad-config.json.

Segue o fluxo interno simplificado de onde ele busca:

  1. Verifica o arquivo .env

  • Lê variáveis como:

    OPENAI_API_KEY=sk-xxxx ANTHROPIC_API_KEY=sk-xxxx GOOGLE_API_KEY=AIza-xxxx * Define a prioridade da LLM padrão (OpenAI, Anthropic, Gemini etc.).

  1. Verifica o bmad-config.json

  • Caso exista, esse arquivo sobrescreve a configuração global e pode definir agentes com LLMs diferentes:

    { "default_model": "gpt-4o-mini", "agents": { "pm": "claude-3.5-sonnet", "ux-expert": "gemini-1.5-pro" } }

  1. Durante a execução no terminal ou no Claude Code:
  • O comando npx bmad-method ... faz chamadas à LLM via API HTTP (exemplo: api.openai.com ou api.anthropic.com).
  • Se estiver rodando no Claude Code, o terminal integrado executa localmente, mas ainda usa as chaves do .env.
  1. Resumo técnico:
  • Origem da API → .env ou bmad-config.json
  • Acesso → via Node.js local (requisição HTTPS)
  • Não há diferença entre rodar no Claude Code ou no terminal comum, desde que o .env esteja corretamente configurado.

BMAD - Como Usar

chatgpt.com ↗

1

Recursos

↑ voltar ao topo · ver no Telegram ↗