Codex-Launcher---Any-AI-Porovider/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project

Codex Launcher — Any AI Provider. Run OpenAI Codex CLI & Desktop with any AI provider.

Pre-Commit Checklist

• Run unit tests: python -m pytest tests/ -v (all must pass)
• Verify cross-platform: no os.getpgid, /proc/, pgrep, SIGUSR* without sys.platform guard
• Check syntax: python -c "import py_compile; py_compile.compile('src/translate-proxy.py', doraise=True)"
• No hardcoded Unix paths or Windows-only APIs without platform checks
• No secrets or API keys in source code

Development Commands

# Run tests
python -m pytest tests/ -v

# Syntax check
python -c "import py_compile; py_compile.compile('src/translate-proxy.py', doraise=True)"

# Run proxy locally
python src/translate-proxy.py --port 8080

Agent Guidelines

See @AGENTS.md for architecture details, platform compatibility rules, and coding conventions.