Claude Code × GPT-6 Astra Windows Playbook
==========================================

파일
----
- nv-codex.ps1 : Windows PowerShell 실행 스크립트
- README.txt    : 이 문서
- SHA256SUMS.txt: 패키지 내부 파일 무결성 확인용 SHA-256

목적
----
Claude Code의 인터페이스와 세션 흐름을 유지하면서
codex-for-claude-code 브리지를 통해 GPT-6 Astra를 실행할 때
매번 긴 명령을 입력하지 않도록 실행/점검/세션 Import 절차를 묶은 스크립트입니다.

주의
----
- codex-for-claude-code는 OpenAI나 Anthropic의 공식 통합 기능이 아닙니다.
- 새 프로젝트이거나 세션 연속성이 필요 없다면 Codex CLI를 직접 쓰는 편이 더 단순할 수 있습니다.
- -Import는 기본 실행 경로가 아니라 direct resume과 재시작이 실패했을 때 사용하는 폴백입니다.
- 세션 JSONL에는 대화 및 도구 실행 기록이 포함될 수 있으므로 외부에 공유하지 마세요.
- 회사/고객 환경에서는 보안 정책과 OAuth/프록시 사용 허용 여부를 먼저 확인하세요.

요구 사항
---------
- Windows PowerShell 또는 PowerShell 7
- Node.js 20+
- Claude Code
- OpenAI Codex CLI
- codex-for-claude-code
- Codex CLI에서 ChatGPT 계정 로그인 완료

설치 예
-------
npm install -g @openai/codex@latest
npm install -g codex-for-claude-code@latest
codex login

사용법
------
1) 먼저 점검

    .\nv-codex.ps1 -Check

2) 현재 폴더를 프로젝트로 실행

    .\nv-codex.ps1

3) 다른 프로젝트 경로 지정

    .\nv-codex.ps1 -ProjectPath "C:\path\to\project"

4) 세션 UUID로 직접 resume

    .\nv-codex.ps1 -Resume "<SESSION_UUID>"

5) direct resume이 실패할 때만 특정 세션 Import

    .\nv-codex.ps1 -Import "<SESSION_UUID>"

6) 기존 브리지 사본을 정말 덮어써야 할 때만

    .\nv-codex.ps1 -Import "<SESSION_UUID>" -Force

실행 정책에 막힐 때
------------------
현재 PowerShell 창에만 적용:

    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

실행 후 반드시 확인
------------------
Claude Code TUI에서 /status 실행:

- Anthropic base URL : http://127.0.0.1:3099
- Model              : gpt-6-astra
- 세션 내용          : 이전 대화/문맥이 실제로 보이는지

버전
----
공개용 패키지: 2026-09-14
기본 모델: gpt-6-astra
