Free & open source · MIT licensed

Codex GPT models.
Claude Code interface.

Claudex configures the local bridge automatically, reuses an existing Codex login or guides you through browser sign-in, and preserves the Claude Code workflows you know.

Free, open download View on GitHub
macOS Linux Windows WSL
claudex — zsh 

        

      

    

  


  
  

    

      
The whole point

      
Free, open download.

      
One command installs Claudex from its verified source release and sets up everything it needs.


      

        MIT license
        Open source
        macOS · Linux · Windows
      


      

        

          
          
          
          
        


        

          

            curl -fsSL --proto '=https' --tlsv1.2 https://claudex.work/install.sh | bash
            
          

          
Verified source install · macOS, Linux, and WSL

        


        

          

            irm https://claudex.work/install.ps1 | iex
            
          

          
Run in PowerShell · verified Windows source install

        


        

          

            npm install --global claudex-codex
            
          

          
Package-manager install · then run claudex

        

      


      

        The installer adds Claude Code and the Codex CLI when needed, opens the official Codex
        browser login when authentication is required, and verifies release downloads with SHA-256.
        Claudex then keeps itself up to date. See the README for details.
      

    

  


  
  

    

      
See it in action

      
Built for real terminal sessions


      

        

          
Switch models mid-flow

          
Friendly aliases for every job — Sol for the hardest reasoning,
             Terra for balanced implementation, Luna for fast,
             bounded work. Solplan plans with Sol and hands the build to Terra,
             automatically.

        

        

          

            

              
              claudex — model picker
            

            

          

        

      


      

        

          
Know your usage before you hit it

          
The status line never blocks on network I/O — it reads a cached, sanitized
             summary and refreshes it in the background. Run /usage-limit any time
             for the full breakdown, straight from your Codex account.

        

        

          

            

              
              claudex — usage limit
            

            

          

        

      


      

        

          
Verified, isolated, and honest about it

          
claudex --doctor reports bridge health, proxy version, and
             authentication state at a glance — and never prints a token while doing it.

        

        

          

            

              
              claudex — doctor
            

            

          

        

      

    

  


  

  
  

    

      
Everything it adds

      
A bridge, not a fork


      

        

          

            
          

          
Guided Codex sign-in

          
Reuses your existing Codex session, or opens the official browser login only when authentication is needed.

        


        

          

            
          

          
Friendly model aliases

          
Sol, Terra, Luna, and Solplan map onto Codex's GPT-5.6 models for the work each is best at.

        


        

          

            
          

          
Solplan workflow

          
Plan with Sol, implement with Terra — one command, no manual handoff.

        


        

          

            
          

          
Stable context accounting

          
Tracks context honestly and compacts automatically near 280k tokens — no false zeroes.

        


        

          

            
          

          
Usage limits in the status line

          
5-hour and 7-day Codex windows, always visible, with a full report on demand.

        


        

          

            
          

          
Truly cross-platform

          
macOS, Linux, Windows, and WSL — Bash and PowerShell kept in behavioral parity.

        


        

          

            
          

          
One-command setup

          
Installs missing Claude Code and Codex CLI dependencies, then checks the complete local bridge.

        


        

          

            
          

          
Automatic updates

          
Checks for new releases in the background and applies SHA-256-verified updates without interrupting your work.

        

      

    

  


  

  
  

    

      
Under the hood

      
How Claudex works

      
A launcher, not a fork. Nothing about the signed Claude Code binary ever changes.


      

        
      

    

  


  
  

    

      
Security posture

      

        

          

            
          

          
Never patches or forks the signed Claude Code executable.

        

        

          

            
          

          
The local bridge binds to 127.0.0.1 only, guarded by a generated key.

        

        

          

            
          

          
Every downloaded binary is pinned by version and verified by SHA-256.

        

        

          

            
          

          
Credentials live under ~/.config/claudex — never in args, logs, or Git.

        

      

    

  


  
  

    

      

        
        
Ready to run Codex in Claude Code?

        
Free, open source, and installed entirely on your own machine.

        

          
            Free, open download
          
          
            
            Star on GitHub