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

# Local agents

> Run Kombai with your existing Claude Code or Codex subscription.

Kombai can use your existing Claude Code or Codex subscription to perform your tasks. It uses the CLI installed on your machine, so you can run more tasks. It also helps keep costs down by making use of what you already pay for.

## Before you start

Ensure you have the agent's CLI installed and meet at least the minimum version listed below.

<Tabs>
  <Tab title="macOS, Linux, and WSL">
    | Agent       | Minimum version | Install                                           | Update          |
    | ----------- | --------------- | ------------------------------------------------- | --------------- |
    | Claude Code | `2.1.119`       | `curl -fsSL https://claude.ai/install.sh \| bash` | `claude update` |
    | Codex       | `0.142.0`       | `npm install -g @openai/codex`                    | `codex update`  |
  </Tab>

  <Tab title="Windows PowerShell">
    | Agent       | Minimum version | Install                                                                                    | Update          |
    | ----------- | --------------- | ------------------------------------------------------------------------------------------ | --------------- |
    | Claude Code | `2.1.119`       | `irm https://claude.ai/install.ps1 \| iex`                                                 | `claude update` |
    | Codex       | `0.142.0`       | `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"` | `codex update`  |
  </Tab>
</Tabs>

Sometimes, Kombai can't run a local agent because the CLI isn't installed, is too old, or the operating system refused to start it. The agent row in the Model dropdown shows a status label to indicate the problem.

| Label               | What it means                                                                   |
| ------------------- | ------------------------------------------------------------------------------- |
| **Not installed**   | No binary was found on your `PATH` or in any of the standard install locations. |
| **Can't start**     | A binary was found, but the operating system refused to start it.               |
| **Update required** | The binary is installed but older than the minimum version above.               |

If you see one of these labels, hover over the agent row. A hover card explains the problem, provides the command to fix it, and links to the provider's guide.

## Select a local agent

<Steps>
  <Step title="Open the Model dropdown">
    Click the Model dropdown in Kombai's chat window.
  </Step>

  <Step title="Select the agent and model">
    Under **Local Agents**, hover over the agent you want to use. Then, select the exact model and thinking effort you want for your tasks.
  </Step>

  <Step title="Send your message">
    The Model dropdown shows the selected agent and model. For example, **Codex · GPT-6-Astra**.
  </Step>
</Steps>

## Switch between Claude Code, Codex, and the Kombai Agent in a single chat

Kombai lets you switch between Claude Code, Codex, and the Kombai Agent in the same chat. You can switch to continue a task with another agent or compare responses from different agents or models.

You can also use different agents at different stages of a task. For example, you might design with the Kombai Agent, implement it with Claude Code, and review the implementation with Codex. Within the Kombai Agent, you can select an individual model or a Model Router as your requirements change.

Kombai provides the selected agent with the prior conversation and records of tool results and file changes, so it can build on the work already done. You can switch back to an earlier agent after others have contributed.

To switch, open the Model dropdown and select another agent, model, or model router from Kombai for your next message.