Skip to main content

​
Prerequisites

Coddo runs on top of two CLIs: Claude Code (from Anthropic) and OpenAI Codex CLI. You don’t need both — install whichever provider you want to use, or both to switch between them per task.

​
Claude Code

Claude Code is a CLI tool from Anthropic. Install it with one of the following: Verify it works and authenticate: 
claude --version   # Should print a version number
claude             # Follow the prompts to authenticate
You need an active Claude subscription (Claude Pro, Team, or Enterprise) to use Claude Code.

​
OpenAI Codex CLI

Codex CLI is OpenAI’s coding agent. Install it via npm or Homebrew: 
npm install -g @openai/codex
Verify it works and authenticate: 
codex --version   # Should print a version number
codex             # Follow the prompts to authenticate
You need an OpenAI account with API access to use Codex. Coddo supports the GPT-5.5, GPT-5.4, GPT-5.4 Mini, 5.3 Codex, and 5.3 Codex Spark models.
You can install either CLI on its own — Coddo will detect what’s available and let you pick the provider per chat or per task. The provider step in onboarding can also be skipped if you want to configure it later from Settings.

​
Download Coddo

macOS

Download the .dmg file from coddo.ai.
  1. Open the .dmg file
  2. Drag Coddo into your Applications folder
  3. Open Coddo from Applications

Windows

Download the .exe installer from coddo.ai.
  1. Run the .exe installer
  2. Follow the installation steps
  3. Open Coddo from the Start menu
If Windows SmartScreen flags the installer, click More info then Run anyway to proceed.
Linux version is coming soon.

​
First launch

When you open Coddo for the first time, you’ll go through a quick onboarding:
  1. Welcome screen - Overview of Coddo
  2. Provider check - Coddo detects which CLIs are installed (Claude Code, Codex, or both) and verifies they’re authenticated. You can skip this step and configure providers later from Settings
  3. Login - Sign in with your Coddo account (Google or email/password) — optional
  4. Ready - You’re all set to start using Coddo
Creating a Coddo account is free and optional. All your project data stays local on your machine regardless.

​
Updates

Coddo checks for updates automatically. When a new version is available, you’ll see a banner in the app. You can also check manually from Settings → Check for updates.