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

# Use a local agent (Claude Code, Codex)

If you already use Claude Code or Codex, Milton can use it as the agent in your projects. It runs on your own account with its provider. Milton charges no credits for it, and it works on the free plan.

## Before you start

1. Install the command-line tool on your device:
   * Claude Code (`claude`), version 2.1.310 or later
   * Codex (`codex`), version 0.166.0 or later
2. Open a terminal and sign in to it once.
3. In Milton, go to **Settings** → **AI management** → **Local agents**. A check mark shows the agent is ready. Without one, point at the agent to see what's missing ("Not installed", "Needs an update", "Could not start" or "Sign in: open *Name* in a terminal"), fix that and click **Check again**.

![Settings, AI management, Local agents, with Claude Code and Codex and whether each is ready](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/local-agents-settings.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=b66470788756be383186932473a4ec84)

> [!WARNING]
>
> The local agent's provider (Anthropic for Claude Code, OpenAI for Codex) receives the content the agent works on, under your account with them.

## Use it

1. Open a project and its **Agent panel** (the robot icon).
2. Open the model menu.
3. Under **On this device**, choose **Claude Code** or **Codex**.

![The model menu with On this device: Claude Code and Codex](https://mintcdn.com/milton-help/CQbZfUaauwZBJQyI/images/local-agents-model-menu.png?fit=max\&auto=format\&n=CQbZfUaauwZBJQyI\&q=85\&s=ff45238ecc35503ca8214394a775f00f)

Work as with the [built-in agent](https://help.milton.so/ai/write-with-the-agent.md): its changes come back as suggestions you apply or discard.

## Permission requests

When the agent wants to run a tool, Milton asks: **Reject**, **Allow once** or **Always allow in this project**. (Running shell commands is never "always allowed".)

To take back an "always allow", go to **Settings** → **AI management** → **Local agents** → **Always allowed** and click **Remove**.

## Choose its model

1. In the model menu, under **On this device**, expand **Claude Code** or **Codex**.
2. Choose **Default (your setting)** or a model.

**Default (your setting)** uses the model set in the tool itself. For Claude Code, Milton lists Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5 and Claude Fable 5.1. For Codex, it lists the models your own Codex offers.

The model menu then shows your choice, for example "Claude Code · Opus 5.5", or "Claude Code on device" with the default.

## If it doesn't start

* "*Name* was not found on this device. Check it in Settings → AI management.": install it, or click **Check again**.
* "Sign in again in *Name*, then send your request again.": sign in from a terminal.

Local agents are available in project chats only.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.