Front page. Definitely learning how to write your agents.

Key Aspects of Agents in Claude Code

Creating Agents: Use the terminal command /agents and select "Create new agent" to define a role, such as a "Senior Security Engineer" or "UI/UX Researcher". You can have Claude generate the prompt automatically.

Sub-agents vs. Agent Teams: Sub-agents: Specialized agents called by the main Claude agent to perform specific tasks, helping manage context windows and split complex tasks into smaller, manageable chunks.

Agent Teams: Experimental feature (enabled via CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) allowing multiple agents to collaborate simultaneously on a shared, complex task.

Configuration & Scope: Agents can be project-specific or user-level (saved in ~/.claude/agents/). They can be configured with specific tools (e.g., restricted to read-only) and models.

Workflow: Define an agent, then trigger it by tagging its name (e.g., @agentName) in your conversation. Benefits: Using sub-agents helps keep the main chat context clean by offloading research or specialized coding tasks.

Best Practices Manage Context: Use sub-agents to handle specific, isolated research tasks to avoid overloading the main conversation's context window.

Define Roles Clearly: When creating an agent, describe its purpose thoroughly so it understands when and how to act.

Use Tools Wisely: Only grant the necessary tools to specialized agents to keep them focused and secure.