# 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

```bash
# 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.