> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coddo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Download and install Coddo on macOS or Windows.

## 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:

<Tabs>
  <Tab title="Install script (recommended)">
    The simplest way to install Claude Code:

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install claude-code
    ```
  </Tab>

  <Tab title="npm">
    If you already have Node.js installed:

    ```bash theme={null}
    npm install -g @anthropic-ai/claude-code
    ```
  </Tab>
</Tabs>

Verify it works and authenticate:

```bash theme={null}
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:

<Tabs>
  <Tab title="npm">
    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

Verify it works and authenticate:

```bash theme={null}
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.

<Tip>
  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.
</Tip>

## Download Coddo

<CardGroup cols={2}>
  <Card title="macOS" icon="apple">
    Download the `.dmg` file from [coddo.ai](https://coddo.ai/download).

    1. Open the `.dmg` file
    2. Drag **Coddo** into your **Applications** folder
    3. Open Coddo from Applications
  </Card>

  <Card title="Windows" icon="desktop">
    Download the `.exe` installer from [coddo.ai](https://coddo.ai/download).

    1. Run the `.exe` installer
    2. Follow the installation steps
    3. Open Coddo from the Start menu

    <Tip>If Windows SmartScreen flags the installer, click **More info** then **Run anyway** to proceed.</Tip>
  </Card>
</CardGroup>

<Info>Linux version is coming soon.</Info>

## 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

<Info>Creating a Coddo account is free and optional. All your project data stays local on your machine regardless.</Info>

## 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**.