O que é Codex Security CLI and SDK?
Codex Security é o scanner de vulnerabilidades da OpenAI baseado em modelos, e este repositório contém a ferramenta de linha de comando (cs ou codex-security), o SDK em TypeScript, o plugin do Codex e a GitHub Action. Ele analisa um repositório, caminhos escolhidos ou um diff do Git, salva um relatório em Markdown com evidências do código e pode validar achados, gerar patches, verificar correções, rascunhar um SECURITY.md e exportar SARIF, JSON ou CSV. Os achados podem ir para Linear, Jira ou GitHub.
A análise roda em um provedor de modelos: OpenAI, via login no ChatGPT ou chave de API, ou Amazon Bedrock, OpenRouter, Fireworks AI ou Cheaper Inference. O cliente é Apache-2.0 e está público desde o fim de julho de 2026; a versão npm v0.10.0 saiu em 12 de novembro de 2026.
Codex Security CLI and SDK vale a pena?
É uma ferramenta de segurança séria, que evolui rápido, de um fornecedor que documenta os próprios limites com detalhe incomum. Um modelo lê o código no contexto, como um revisor faria, em vez de procurar padrões, e cada achado vem com evidências salvas para que uma pessoa possa conferir o raciocínio. Uma análise Standard, uma análise Deep que repete análises Standard e remove duplicatas, análises de diff para pull requests e a exportação em SARIF cobrem quase tudo o que uma equipe de segurança precisa na CI.
Aqui o que a ferramenta consegue alcançar pesa mais do que na maioria das ferramentas. O SECURITY.md diz que ela roda com a sua conta local e pede que você analise apenas repositórios confiáveis. A geração de políticas tem acesso somente leitura ao código selecionado, com rede, web, apps e MCP desativados. A validação de achados é somente leitura, com rede e busca na web desligadas, e não executa builds, testes, exploits de prova de conceito nem a aplicação. O patch é a etapa que escreve: verifica se o sandbox sobe e, se não, recusa com SANDBOX_UNAVAILABLE, enquanto --external-sandbox desliga o controle de arquivos e rede do Codex e deixa o isolamento para o seu contêiner. Os workers da análise Deep são somente leitura, mas, nas palavras da OpenAI, não são um ambiente isolado e offline, e herdam os servidores MCP da sessão principal. Seu código vai para o provedor de modelos que você escolher.
O porém: o cliente é aberto, mas o scanner é um modelo que você paga, e algumas requisições e achados protegidos exigem o programa Trusted Access for Cyber da OpenAI. Os custos são estimativas, --validate não pode ser combinado com --max-cost e a documentação avisa que no macOS as restrições de escrita em /tmp não são totalmente aplicadas. O projeto anda rápido, com 12.856 estrelas, 156 issues e pull requests abertos e notas de atualização no changelog das versões recentes, então vale fixar a Action em um SHA de commit revisado, como o README pede.
Nossa opinião: o lugar natural dele são os diffs de pull requests e análises completas semanais, com uma pessoa lendo cada relatório antes de um patch entrar. Ele funciona ao lado de um scanner convencional como Trivy ou Semgrep, mais barato por execução e determinístico, e não no lugar dele.
Onde ele se destaca
Uma equipe de plataforma com GitHub Actions em 40 repositórios
Ter um relatório semanal de vulnerabilidades por repositório sem contratar outro SaaS
Copie o workflow semanal, adicione CODEX_SECURITY_API_KEY e fixe o SHA de commit revisado. O exemplo limita cada análise a cerca de $5 estimados e reporta achados sem fazer o job falhar.
Um engenheiro de segurança revisando um serviço de pagamentos
Checar as mudanças de uma pull request em busca de falhas de autenticação e injeção antes do merge
cs scan . --diff origin/main analisa só as mudanças commitadas; --validate reavalia cada achado em somente leitura, com rede e busca na web desligadas. As chamadas de validação não entram na conta de custo, então acompanhe o gasto.
A líder de segurança de uma empresa SaaS de 30 pessoas
Escrever um SECURITY.md e um modelo de ameaças para a API principal
cs policy . --path services/api rascunha a política fora do repositório sem alterar arquivos existentes; cs export extrai o modelo de ameaças salvo em Markdown para revisão.
Antes de decidir
- Configuração
- Node.js 22.13+ (22.x), 24.x ou 26.x e Python 3.10+. npm install --global @openai/codex-security, cs login e depois cs scan . no repositório; na CI, OPENAI_API_KEY ou CODEX_API_KEY.
- Integrações
- Plugin do Codex, SDK em TypeScript, GitHub Action, GitLab CI, análises em lote com Docker Compose; issues no Linear, Jira e GitHub; exportações SARIF, JSON, CSV e ServiceNow; importa resultados de outros scanners, como CrowdStrike.
- Dados e privacidade
- O código é enviado ao provedor de modelos que você configurar. O estado das análises fica em um diretório local. A análise de uso do Codex fica ativa a menos que você passe --codex analytics.enabled=false. Roda com a sua conta local; os workers Deep herdam os servidores MCP da sessão principal.
- Custo em escala
- Uso de modelo por análise; análises Deep repetem análises Standard e custam mais. --max-cost e --max-total-cost definem limites estimados; os minutos do GitHub Actions são à parte.
- Limites
- Os limites de custo são estimativas e requisições em andamento podem ultrapassá-los; execuções de teste não verificam o sandbox da análise Deep; no macOS as restrições de escrita em /tmp não são totalmente aplicadas; alguns achados exigem Trusted Access for Cyber.
O que é bom
- Salva evidências do código para cada achado
- A validação é somente leitura, com rede e busca na web desligadas
- Análises de diff, exportação SARIF e uma GitHub Action fixada se encaixam na CI
- Funciona com OpenAI, Bedrock, OpenRouter e Fireworks AI
O que não é
- Roda com a sua conta; os workers Deep não são isolados e herdam servidores MCP
- Cada análise custa uso de modelo, e os limites de custo são estimativas
- Alguns achados exigem aprovação no Trusted Access for Cyber
- CLI que muda rápido, com notas de atualização frequentes
Ideal para
Equipes de segurança e plataforma que querem revisão de código por modelo na CI e podem ter uma pessoa lendo cada relatório.
Alternativas ao Codex Security CLI and SDK
Codex Security CLI and SDK: perguntas frequentes
- Codex Security CLI and SDK vale a pena?
- Um scanner de segurança cuidadoso e bem documentado, desde que você o trate como um modelo lendo seu código com a sua própria conta, e não como um sandbox isolado. Damos nota 4.1 de 5.
- Quanto custa Codex Security CLI and SDK?
- O cliente é gratuito sob Apache-2.0. As análises consomem uso de modelo do seu plano do ChatGPT ou da sua chave de API; a GitHub Action de exemplo define um limite estimado de $5 por análise, que requisições em andamento podem ultrapassar.
- Quais são as desvantagens de Codex Security CLI and SDK?
- Roda com a sua conta; os workers Deep não são isolados e herdam servidores MCP; cada análise custa uso de modelo, e os limites de custo são estimativas; alguns achados exigem aprovação no Trusted Access for Cyber; cLI que muda rápido, com notas de atualização frequentes.
- Para quem Codex Security CLI and SDK é indicado?
- Equipes de segurança e plataforma que querem revisão de código por modelo na CI e podem ter uma pessoa lendo cada relatório.
- Quanto custa Codex Security CLI and SDK para uma equipe ou em produção?
- Uso de modelo por análise; análises Deep repetem análises Standard e custam mais. --max-cost e --max-total-cost definem limites estimados; os minutos do GitHub Actions são à parte.
- Codex Security CLI and SDK é seguro para dados da empresa?
- O código é enviado ao provedor de modelos que você configurar. O estado das análises fica em um diretório local. A análise de uso do Codex fica ativa a menos que você passe --codex analytics.enabled=false. Roda com a sua conta local; os workers Deep herdam os servidores MCP da sessão principal.
- Quais são as melhores alternativas ao Codex Security CLI and SDK?
- As alternativas mais próximas que analisamos são Trivy, security-guidance plugin (Claude Code), Cloudflare Security Audit Skill e Open Code Review.
Respostas verificadas em 13 de nov. de 2026.
Você faz o Codex Security CLI and SDK? Mostre esta nota no seu site
