ryfineZ/codex-session-patcher

A lightweight Python tool to clean AI refusal responses from Codex CLI session files

해결하는 문제

Codex, Claude Code, OpenCode와 같은 AI 코드 보조 도구는 보안 작업을 포함하는 요청을 종종 거부하며, 이는 보안 테스트, CTF(캡처 더 플래그) 대회, 침투 테스트 중 대화 흐름을 방해합니다. 이 프로젝트는 이러한 거부 응답을 세션 기록에서 정리하고, 향후 거부 가능성을 줄이기 위해 특화된 프롬프트를 주입하는 도구를 제공합니다.

작동 방식

이 도구는 두 가지 주요 메커니즘을 통해 작동합니다:

세션 정리: JSONL 또는 SQLite 형식의 세션 파일을 스캔하여 강력한 문구 일치 및 약한 키워드 일치를 사용한 이중 검출 전략으로 거부 응답을 탐지합니다. 이후 안전한 기본 텍스트로 대체하거나, OpenAI, Ollama, OpenRouter를 통해 LLM을 호출하여 대화 맥락에 맞는 대체 내용을 생성할 수 있습니다. 또한 추론/사고 블록을 제거하여 기록을 정리합니다.
프롬프트 인젝션: 설정 파일을 수정하거나 전용 워크스페이스를 생성하여 CTF 전용 시스템 프롬프트를 주입합니다. Codex의 경우 별도의 프로필을 생성하거나 글로벌 설정을 수정할 수 있습니다. Claude Code 및 OpenCode의 경우, CLAUDE.md 또는 AGENTS.md와 같은 프로젝트 수준 지침 파일을 갖춘 전용 워크스페이스를 설정합니다.

대상 사용자

AI 코드 보조 도구를 활용해 보안 관련 작업을 수행하고, AI 안전 필터로 인한 세션 중단을 피하고자 하는 보안 연구자, CTF 참가자, 침투 테스터.

주요 기능

다중 플랫폼 지원: Codex CLI, Claude Code, OpenCode 모두 호환.
AI 기반 재작성: 대화 맥락을 기반으로 거부된 응답에 대한 자연스러운 대체를 LLM으로 생성.
유연한 인젝션: Codex에 대해 프로필 기반 및 글로벌 프롬프트 인젝션 모두 지원.
포괄적인 UI: 세션 관리, 변경 사항의 시각적 비교, 프롬프트 편집을 지원하는 웹 UI 포함.
안전 기능: 정리 전 자동 백업 생성 및 한 번의 클릭으로 복원 가능.