AI 튜토리얼

Portable Setup Kit으로 실행 우선 Codex CLI 작업 공간 구축

Windows에서 Codex CLI Portable Setup Kit을 구성하고 TURBO 워크플로를 실행하는 방법을 알아보세요. 트랜잭션 방식 설치를 확인하고, 번들로 제공되는 리버스 엔지니어링 도구를 사용하며, 지원되는 AI 에이전트를 동기화하고, 영수증 기반 롤백으로 이전 파일을 복원할 수 있습니다.

2026년 9월 1일약 17분 소요

Portable Setup Kit으로 실행 우선 Codex CLI 작업 공간 구축

Codex CLI Portable Setup Kit의 기능

Codex CLI Portable Setup Kit은 OpenAI Codex CLI를 위한 커뮤니티 유지 관리 구성 및 설치 도구입니다. Codex 자체가 아니며 공식 OpenAI 제품도 아닙니다.

이 키트는 Codex가 저장소 작업에 접근하는 방식을 바꿉니다. 지침은 작업 공간을 검사하고, 사용 가능한 도구를 활용하며, 요청된 변경을 적용하고, 검사를 실행하고, 실패를 진단하고, 검증된 결과를 보고하는 작업을 강조합니다. 이식성은 제공 방식이며, 핵심 제품은 이러한 실행 우선 운영 방식입니다.

중요: TURBO 모드는 approval_policy = "never"를 포함한 권한 상승 및 비대화형 동작을 활성화합니다. 신뢰할 수 있는 작업 공간에서 패키지를 검토한 후에만 사용하세요. 기본 공개 구성은 더 안전한 요청 시 승인 및 workspace-write 샌드박싱으로 시작합니다.

주요 기능

실행 우선 지침: Codex가 일반적인 조언이나 계획 제시에서 멈추지 않고 실제 대상에 대해 작업하도록 지시합니다.
원클릭 TURBO 실행: TURBO.cmd가 작업 공간을 검증하고, 권한 상승 실행 정책을 구성하며, 기본 모델 설정을 상속하고 Codex를 시작합니다.
트랜잭션 방식 설치: 설치 프로그램이 SHA-256 매니페스트를 검증하고, 타임스탬프가 포함된 백업을 생성하며, 작업을 저널링하고, 롤백 영수증을 생성합니다.
결정론적 분석 도구: 순수 Python으로 작성된 re-toolkit이 PE32 및 PE32+ 검사, x86 및 x64 디스어셈블리, AOB 스캔, 마이크로 에뮬레이션, Protobuf 및 TLV 분석, Frida 후크 생성, 바이너리 차이 분석을 처리합니다.
이중 단계 처리: 구조적 계획을 고충실도 렌더링과 분리하여 자리 표시자 아티팩트와 품질이 저하된 장문 출력을 줄입니다.
다양한 에이전트 형식: Codex CLI, OpenCode, Claude Code, Cursor, Windsurf 및 ChatGPT App용 지침 또는 프리셋을 제공합니다.
연속성 지원: 후크와 컨텍스트 도구가 장시간 작업 중 검증된 상태를 유지하도록 지원합니다.
되돌릴 수 있는 Git 통합: 설치 프로그램이 core.hooksPath를 패키지된 pre-commit 가드에 연결하고, 롤백 중 이전 값을 복원할 수 있습니다.

요구 사항 및 준비

저장소는 Windows 10 및 11, PowerShell 5.1 또는 7, Python 3.10 이상을 지원 구성 요소로 명시합니다. 기본 워크플로에는 Codex CLI가 필요하지만, Codex가 없으면 설치 프로그램이 호환성이 고정된 전역 @openai/codex 패키지를 추가할 수 있습니다.

릴리스 ZIP을 다운로드하거나 저장소를 복제합니다.
ZIP을 다운로드한 경우 로컬 디렉터리에 압축을 풉니다.
Codex가 관리할 저장소를 선택합니다.
권한 상승 또는 제한 없는 실행을 활성화하기 전에 포함된 스크립트와 구성을 검토합니다.
설치 프로그램이 트랜잭션 백업을 생성하더라도 특히 중요한 작업 공간 데이터는 별도로 백업합니다.

옵션 1: TURBO 모드로 시작

가장 간단한 설정 경로를 사용하려면 릴리스를 압축 해제한 후 다음 파일을 두 번 클릭합니다.

TURBO.cmd

실행 프로그램이 작업 공간을 검증하고, 권한 상승 실행 프로필을 구성하며, 기본 모델 설정을 사용하고, 바로 작업할 수 있는 Codex를 엽니다. 이 모드는 런타임 도구를 미리 승인하고, 작업 공간을 완전히 신뢰할 수 있는 것으로 표시하며, 비대화형 승인 동작을 사용합니다.

이러한 설정은 확인 절차를 줄이므로 검토된 코드와 신뢰할 수 있는 작업 공간에서만 TURBO 모드를 사용하세요. 더 세밀하게 제어되는 설치를 원한다면 아래의 수동 절차를 사용합니다.

옵션 2: 수동 트랜잭션 방식 설치 수행

압축을 푼 키트 디렉터리에서 PowerShell을 엽니다. 현재 PowerShell 프로세스에 한해 설치 스크립트를 임시로 허용한 다음, 대상 작업 공간의 절대 경로를 제공합니다.

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1 -ProjectRoot 'C:\path\to\your-workspace' -KeysmithPreset unrestricted -SkipPlugins

이 예시는 unrestricted Keysmith 프리셋을 선택하고 선택적 플러그인을 건너뜁니다. 환경에서 사용하기 전에 이 선택 사항을 검토하세요.

설치 중 키트는 다음 트랜잭션 순서를 따릅니다.

프로젝트 루트를 검증합니다.
SHA-256 매니페스트를 기준으로 소스 패키지를 검증합니다.
타임스탬프가 포함된 백업과 작업 저널을 생성합니다.
사용자 파일, 스킬, 프로젝트 파일, 컨텍스트 도구 및 re-toolkit을 설치합니다.
대상 환경에 필요한 경로를 치환합니다.
프로젝트 신뢰 설정과 저장소 Git 후크 경로를 구성합니다.
요청된 경우 선택적 플러그인 설정을 시도하며, 플러그인 실패를 치명적 오류로 처리하지 않습니다.
receipt.json 및 last-receipt.txt를 작성합니다.

각 치환은 실행되기 전에 기록됩니다. 이후 설치 단계가 실패하면 설치 프로그램이 작업 목록을 역순으로 재생하고 이전 Git 후크 연결을 복원합니다.

설치 프로그램이 추가하는 항목

Codex 사용자 구성: config.toml, AGENTS.md, 지침, 시작 규칙, 스킬을 포함한 %CODEX_HOME% 또는 ~/.codex 아래의 파일입니다.
사용자 수준 에이전트 스킬: ~/.agents 아래의 재사용 가능한 스킬입니다.
프로젝트 구성: AGENTS.md, CLAUDE.md, .codex, .agents, .gitignore, 컨텍스트 워크플로, 훅, 리버스 엔지니어링 도구 모음입니다.
로컬 Git 구성: 선택한 저장소에 적용되는 core.hooksPath=.agents/git-hooks입니다.
Codex CLI: Codex를 이미 사용할 수 없는 경우 호환성이 고정된 전역 npm 설치입니다.
선택적 플러그인: 사용 가능한 경우 Browser, Visualize, Sites 지원을 제공합니다.

이 릴리스에는 자격 증명과 컴퓨터에 종속된 상태가 의도적으로 포함되지 않습니다. 다른 컴퓨터의 인증 데이터, OAuth 데이터, 세션, 기록, 로그, 캐시, SQLite 데이터베이스, 쿠키, API 키, 개인 키, 브라우저 런타임 데이터, 데스크톱 바이너리 경로 또는 컨텍스트 런타임 상태는 마이그레이션하지 않습니다.

패키지 및 설치 확인

설정을 사용하기 전에 패키지 확인 스크립트를 실행하세요.

.\verify.ps1

특정 작업 공간에 설치된 파일을 확인하려면 -Installed와 프로젝트 경로를 추가하세요.

.\verify.ps1 -Installed -ProjectRoot 'C:\path\to\your-workspace'

확인은 이 설계에서 중요한 부분입니다. 설치 프로그램은 파일을 쓰기 전에 매니페스트를 확인하고 매니페스트 경로 탐색을 차단합니다. 저장소에는 릴리스 테스트에 사용하는 9단계 Test-All.ps1 테스트 모음도 설명되어 있습니다.

Codex 기본 사용법

설치가 완료되면 TURBO.cmd 또는 평소 사용하는 Codex CLI 워크플로를 통해 구성된 저장소에서 Codex를 시작하세요. 일반적인 조언을 요청하기보다 구체적인 저장소 작업을 지시하세요.

예를 들어 Codex에 실패한 테스트를 확인하고, 수정 사항을 구현하고, 관련 검사를 다시 실행한 다음 변경된 파일을 요약하도록 요청할 수 있습니다. 설치된 지침은 다음 작업이 가능한 경우 에이전트가 검사에서 구현과 확인까지 계속 진행하도록 설계되었습니다.

적절한 작업은 다음과 같이 작성할 수 있습니다.

이 작업 공간의 실패한 테스트를 확인하고 근본 원인을 파악한 후, 올바른 최소 수정 사항을 구현하고, 영향을 받은 테스트를 다시 실행한 다음, 확인된 결과를 보고하세요.

이 프로필은 Codex가 먼저 파일과 테스트 출력을 확인하고, 실제 프로젝트를 수정하고, 실패한 검사를 재시도한 다음, 사용자가 수동으로 실행해야 하는 튜토리얼 대신 간결한 결과를 제공하도록 유도합니다.

기본 제공 re-toolkit 사용

도구 모음은 프로젝트 내부의 .agents/tools/re-toolkit/에 설치됩니다. 통합 진입점은 cli.py입니다. --json을 지원하는 명령은 다른 스크립트나 에이전트에서 구조화된 출력이 필요할 때 특히 유용합니다.

바이너리 자동 분류

python .agents/tools/re-toolkit/cli.py auto target.dll --json

대상의 형식을 자동으로 탐색하고 분류합니다.

PE 파일 검사

python .agents/tools/re-toolkit/cli.py parse-pe sample.exe --json

PE 파서는 PE32 및 PE32+ 파일의 헤더, 섹션 테이블, 가져온 DLL, 내보낸 심볼, RVA 변환 정보를 검사할 수 있습니다.

AOB 패턴 검색

python .agents/tools/re-toolkit/cli.py pattern-scan target.bin --pattern "48 89 ?? 24 ?? 55" --json

바이너리나 버전에 따라 바이트가 달라질 수 있는 경우 와일드카드로 ??를 사용하세요.

문자열 추출

python .agents/tools/re-toolkit/cli.py strings sample.exe --min-len 5 --json

선택한 최소 길이보다 짧은 문자열을 필터링하면서 오프셋과 함께 ASCII 및 UTF-16LE 문자열을 추출합니다.

Opcode 디스어셈블

python .agents/tools/re-toolkit/cli.py disasm 90505831C0C3 --arch x86_64

디스어셈블러는 원시 Opcode 또는 바이너리 섹션의 x86 및 x64 분석을 지원합니다.

문서화되지 않은 Protobuf 페이로드 디코딩

python .agents/tools/re-toolkit/cli.py decode-protobuf 089601120474657374

스키마 없이 Protobuf 와이어 형식 데이터를 검사합니다. 이 하위 시스템에는 TLV 프레임 분석 기능도 포함되어 있습니다.

짧은 명령어 시퀀스 에뮬레이션

python .agents/tools/re-toolkit/cli.py emulate --code B82A000000505BC3

마이크로 에뮬레이터는 지원되는 CPU 수준 분석을 위해 격리된 레지스터, 스택, 메모리 샌드박스를 제공합니다.

Frida 훅 생성

python .agents/tools/re-toolkit/cli.py gen-hook --symbol CryptHashData --module advapi32.dll --output hook.js

선택한 모듈과 심볼에 대한 Frida 인터셉터 스크립트를 생성합니다. 이 도구 모음은 안티 디버깅 스크립트 생성도 지원합니다.

바이너리 차이 패치 계산

python .agents/tools/re-toolkit/cli.py diff-patch --orig orig.bin --patched mod.bin --json

원본 바이너리와 수정된 사본을 비교하고 패치 정보를 출력합니다.

영역을 헥스 덤프로 검사

python .agents/tools/re-toolkit/cli.py hexdump target.bin --offset 0x100 --length 128

0x100 오프셋부터 시작하는 128바이트를 정렬된 16진수 덤프로 표시합니다.

2단계 파이프라인 실행

이 프로젝트에는 구조 계획과 최종 렌더링을 분리하는 2단계 파이프라인이 포함되어 있습니다. 첫 번째 단계에서는 구조와 주요 전개를 만들고, 두 번째 단계에서는 전체 출력을 생성합니다. 이러한 분리는 주의력 붕괴, 잘림, ROLE_A 및 ROLE_B와 같은 문자 그대로의 자리 표시자 잔여물을 줄이기 위한 것입니다.

python .agents/tools/re-toolkit/cli.py pipeline "Your complex scenario or system architecture prompt"

이 워크플로는 세부 생성을 진행하기 전에 명시적인 구조적 준비가 필요한 복잡한 프롬프트에 특히 적합합니다.

기타 지원되는 에이전트 도구 구성

이 패키지에는 여러 에이전트 환경을 위한 기본 구성 파일이 포함되어 있습니다. Codex CLI용 AGENTS.md, OpenCode용 OPENCODE.md 및 opencode.json, Claude Code용 CLAUDE.md, Cursor용 .cursorrules, Windsurf용 .windsurfrules 등이 해당합니다.

워크스페이스에서 지원되는 GPT 기반 에이전트 프레임워크와 IDE 통합을 구성하고 동기화하려면 범용 어댑터를 실행하세요.

ADAPT_ALL.cmd

re-toolkit을 통해 프리셋을 내보낼 수도 있습니다.

python .agents/tools/re-toolkit/cli.py export-preset --target all

저장소에는 docs/CHATGPT_APP_PRESET.md에 별도의 ChatGPT App 프리셋도 포함되어 있습니다.

고급 팁

자동화에는 구조화된 출력 사용

명령에서 지원하는 경우 --json을 사용하세요. PE 파싱, 패턴 스캔, 자동 분류 또는 바이너리 차이 분석의 구조화된 결과는 저장, 비교 및 다른 도구로 전달하기가 더 쉽습니다.

분석 명령 조합

형식 탐색에는 auto로 시작하고, 실행 파일 메타데이터에는 parse-pe를 사용한 다음, 읽을 수 있는 지표를 찾을 때는 strings를 사용하세요. 후보 바이트 시그니처가 있으면 pattern-scan을 적용합니다. 점진적으로 더 깊이 검사하려면 disasm, emulate 또는 gen-hook을 사용하세요.

추측 프로브는 신중하게 사용

이 툴킷은 거부 시 중단하고 장애 조치하는 추측성 이중 모델 섀도 프로브를 제공합니다.

python .agents/tools/re-toolkit/cli.py spec-probe "Reverse engineer target module and extract memory offsets" --target game.dll --json

바이너리 분석 기능은 검사 권한이 있는 소프트웨어와 데이터에만 사용하세요.

기록 보관

설치를 되돌려야 할 가능성이 있다면 생성된 기록을 삭제하지 마세요. 이 기록에는 새로 설치된 파일을 제거하고, 교체된 파일을 복원하며, 이전 Git 훅 구성을 복구하는 데 필요한 작업 순서가 저장됩니다.

표준 보안 기본값 이해

명시적으로 선택한 TURBO 동작을 제외하면 공개 버전은 다음과 같이 검토 가능한 설정으로 시작합니다.

approval_policy = "on-request"
sandbox_mode = "workspace-write"

스타터 규칙에는 TURBO 모드를 선택하지 않는 한 사전 승인된 명령 접두사가 포함되지 않습니다. 확인 경계와 워크스페이스 범위의 쓰기를 원한다면 표준 기본값을 사용하세요.

설치 롤백

최근에 기록된 설치를 복원하려면 다음을 실행하세요.

.\rollback.ps1

특정 트랜잭션을 복원하려면 해당 기록을 명시적으로 지정하세요.

.\rollback.ps1 -Receipt 'C:\path\to\receipt.json'

Git Bash 사용자는 래퍼를 호출할 수 있습니다.

./ROLLBACK.sh

롤백은 설치 프로그램이 추가한 파일을 제거하고, 설치 전에 존재했던 파일을 복원하며, 저장소의 기존 core.hooksPath 값을 복원하거나 설정 해제합니다.

추가 문서

기본 Codex 개념은 공식 문서의 Codex CLI, 구성 기본 사항, AGENTS.md, 규칙, 훅, 스킬, 플러그인을 참조하세요.

결론

Codex CLI Portable Setup Kit은 실행에 초점을 둔 Codex 프로필, 프로젝트 지침, 에이전트 통합, 결정론적 분석 유틸리티, 검증, 백업 및 롤백 기능을 하나의 재현 가능한 설정으로 패키징합니다. 검토 가능한 제어가 필요하다면 먼저 표준 트랜잭션 설치를 진행하고 결과를 확인하세요. 신뢰할 수 있는 워크스페이스에서 상승된 비대화형 동작이 적절한 경우에만 TURBO 모드를 활성화하세요.