Documentation Error: Tool listed as "Agent" should be "Task"

Resolved 💬 3 comments Opened Jul 9, 2025 by poutila Closed Jul 10, 2025

Bug Description

The official Claude Code documentation incorrectly lists a tool called "Agent" which doesn't exist. The actual tool name is
"Task".

## Location of Error

## Current (Incorrect) Documentation
Tool Description Permission Required
Agent Runs a sub-agent to handle complex, multi-step tasks No

## Expected (Correct) Documentation
Tool Description Permission Required
Task Runs a sub-agent to handle complex, multi-step tasks No

## Impact
This error causes several problems:

  1. Users add "Agent" to their settings.json permissions, which has no effect
  2. Users cannot find or use the "Agent" tool because it doesn't exist
  3. Users may not discover the correct Task tool for running sub-agents
  4. Time wasted debugging non-existent functionality

## Steps to Reproduce

  1. Check available tools in Claude Code by running any session
  2. Observe that Task tool exists but Agent tool does not
  3. Try adding "Agent" to settings.json permissions - it has no effect
  4. The correct tool name is Task

## Evidence
When checking available tools in Claude Code, the actual list includes:

  • Task (for running sub-agents)
  • Bash, Edit, Read, Write, MultiEdit
  • Glob, Grep, LS
  • WebFetch, WebSearch
  • TodoWrite
  • NotebookRead, NotebookEdit
  • exit_plan_mode

No tool named "Agent" exists.

## Suggested Fix
Update the documentation table to replace "Agent" with "Task" throughout the tools documentation page.

## Environment

  • Claude Code Version: [current version]
  • Documentation accessed: 2025-01-09

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗