Codex
Connect OpenAI's Codex cloud engineering agent to BitRouter
Codex Integration
Quick Start
# 1. Start BitRouter
bitrouter serve
# 2. Configure Codex CLI
codex config set api.base http://localhost:8787
# 3. Launch Codex
codex initWhat You Get
- ✅ Multi-provider routing - Beyond OpenAI models to Anthropic, Google, etc.
- ✅ Local control - Manage cloud operations from your proxy
- ✅ Cost tracking - Monitor parallel execution spending
- ✅ Fallback providers - Never blocked by OpenAI limits
- ✅ Enhanced security - Guardrails at the proxy layer
Installation
Prerequisites
# Install Codex CLI
npm i -g @openai/codex
# Or use desktop app
# Download from chatgpt.com/codexConnect to BitRouter
Choose your setup:
Option 1: CLI Configuration
codex config set api.base http://localhost:8787
codex config set api.protocol openai
codex initOption 2: Desktop App
export OPENAI_API_BASE=http://localhost:8787
codex-appOption 3: Browser Extension
// In browser console
localStorage.setItem('codex_api_base', 'http://localhost:8787');Essential Configuration
Smart Routing by Task
# ~/.bitrouter/config.yaml
routes:
# Main Codex operations
- match: "codex/main/*"
provider: openai
model: codex-1
# Code review & analysis
- match: "codex/review/*"
provider: anthropic
model: claude-3-5-sonnet-latest
# Test generation
- match: "codex/test/*"
provider: deepseek
model: deepseek-coder
# Documentation
- match: "codex/docs/*"
provider: google
model: gemini-2.0-flash-expParallel Execution Support
routes:
- match: "codex/parallel/*"
provider: openai
model: codex-1
options:
max_parallel: 5
timeout: 300s
load_balancing:
strategy: round_robinAutomation Workflows
automations:
issue_triage:
route: "codex/automation/triage"
provider: openai
model: gpt-4o
schedule: "*/15 * * * *"
ci_monitoring:
route: "codex/automation/ci"
provider: anthropic
model: claude-3-5-haiku-latest
trigger: webhookCommon Recipes
Recipe: High Availability
routes:
- match: "codex/*"
provider: openai
model: codex-1
fallback:
- provider: anthropic
model: claude-3-5-sonnet-latest
- provider: google
model: gemini-2.0-flash-expRecipe: Cost Optimization
cloud_resources:
cost_limits:
hourly: 50.00
daily: 500.00
auto_scale:
enabled: true
min_instances: 2
max_instances: 20Recipe: Skills Integration
skills:
routing:
- skill: "code-understanding"
provider: openai
model: codex-1
- skill: "prototyping"
provider: anthropic
model: claude-3-5-sonnet-latestMonitoring
Session Tracking
# List Codex sessions
bitrouter sessions list --agent codex
# View parallel execution
bitrouter codex status --show-parallel
# Export metrics
bitrouter sessions export --agent codex --format csvCost Analytics
# Spending breakdown
bitrouter costs breakdown --agent codex
# Set budget alert
bitrouter budget set --agent codex --daily 100
# Generate report
bitrouter report generate --agent codex --period monthTroubleshooting
🔴 Connection Failed
# Check BitRouter
curl http://localhost:8787/health
# Verify Codex config
codex config list
# Reset API base
codex config set api.base http://localhost:8787🟡 Cloud Environment Issues
# Test connectivity
bitrouter providers test openai
# Check credentials
codex auth status
# Restart Codex
codex restart🔵 Performance Problems
# Analyze routing
bitrouter performance analyze --agent codex
# Optimize routes
bitrouter routes optimize --agent codex
# Clear cache
bitrouter cache clear --agent codexAdvanced Features
Environment Routing
environments:
development:
route: "codex/dev/*"
provider: openai
model: gpt-4o
production:
route: "codex/prod/*"
provider: openai
model: codex-1
guardrails:
- approval_required
- audit_logSecurity Guardrails
guardrails:
codex:
- type: secret_detection
action: redact
- type: pii_protection
action: block
- type: code_security
scan_for: [sql_injection, xss]Learn More
How is this guide?
Last updated on