> ## Documentation Index
> Fetch the complete documentation index at: https://allhandsai-add-agent-settings-page-and-settings-links.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Settings

> Configure agent behavior, including sub-agent support and agent selection.

## Overview

The Agent settings page controls how the OpenHands agent behaves during conversations — from enabling sub-agents to choosing a different agent entirely.

Navigate to `Settings > Agent` to configure these options.

## Sub-Agent Support

The OpenHands agent supports spawning **sub-agents** to handle parallel or delegated work within a single conversation. When sub-agent support is enabled, the agent can create child agents directly inside the main conversation thread, delegating subtasks to them without leaving the current context.

Enabling this setting adds the `task` tool to the agent's tool set, which it uses to spawn and coordinate sub-agents. Sub-agents share the same conversation thread, so their results surface inline alongside the main agent's output.

<Note>
  Sub-agent support is available on the built-in OpenHands agent. ACP agents manage their own execution model and are not affected by this setting.
</Note>

## Choosing a Different Agent

The Agent settings page is also where you switch from the built-in OpenHands agent to an external **ACP agent** — such as Claude Code, Codex, or Gemini CLI. ACP agents run as subprocesses managed by the Agent Server and use the [Agent Client Protocol](https://agentclientprotocol.com/protocol/overview) to communicate with Agent Canvas.

This lets you bring your own preferred coding agent while keeping the full Agent Canvas experience — conversation history, backend management, secrets, and more.

For step-by-step instructions on onboarding and configuring an ACP agent, see the [ACP Agents guide](/openhands/usage/agent-canvas/acp-agents).

## Related Guides

* [ACP Agents](/openhands/usage/agent-canvas/acp-agents) — Bring your own agent with Claude Code, Codex, or Gemini CLI
* [Customize and Settings](/openhands/usage/agent-canvas/customize-and-settings) — Overview of all settings sections
* [Secrets Management](/openhands/usage/settings/secrets-settings) — Store credentials used by the agent