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

Files
-----
- nv-codex.ps1 : Windows PowerShell launcher
- README.txt    : this document
- SHA256SUMS.txt: SHA-256 checksums for package contents

Purpose
-------
This script packages the recurring launch, preflight, and optional session-import
steps used when running Claude Code through codex-for-claude-code with GPT-6 Astra.

Important
---------
- codex-for-claude-code is not an official OpenAI or Anthropic integration.
- If you do not need Claude Code session continuity, using Codex CLI directly may be simpler.
- -Import is a fallback. Try direct resume and restart both TUIs first.
- Session JSONL files can contain conversation and tool-execution history. Do not publish them.
- In corporate/client environments, verify security policy before using local OAuth/proxy bridges.

Requirements
------------
- Windows PowerShell or PowerShell 7
- Node.js 20+
- Claude Code
- OpenAI Codex CLI
- codex-for-claude-code
- Codex CLI signed in with your ChatGPT account

Install
-------
    npm install -g @openai/codex@latest
    npm install -g codex-for-claude-code@latest
    codex login

Usage
-----
1. Preflight only

    .\nv-codex.ps1 -Check

2. Launch from the current project directory

    .\nv-codex.ps1

3. Launch a specific project

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

4. Resume a known session UUID

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

5. Fallback only: import one session after direct resume fails

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

6. Overwrite an existing bridge copy only when intentional

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

If PowerShell blocks script execution
-------------------------------------
Apply this to the current PowerShell process only:

    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Always verify after launch
--------------------------
Run /status in the Claude Code TUI and verify:

- Anthropic base URL : http://127.0.0.1:3099
- Model              : gpt-6-astra
- Session history    : previous conversation/context is actually visible

Package version
---------------
Published: 2026-09-14
Default model: gpt-6-astra
