---
title: "agent-models"
url: "https://claudemods.dev/ko/builds/agent-models-b7bf79"
source: "https://github.com/alex2481kobe/claude-mods/tree/main/plugins/agent-models"
source_type: "github"
repo: "https://github.com/alex2481kobe/claude-mods/tree/main/plugins/agent-models"
author: "alex2481kobe"
author_handle: "alex2481kobe"
stars: 3
category: "멀티 에이전트 및 오케스트레이션"
categories: ["agents"]
tags: ["agent-list", "claude-code", "hooks", "model-label", "plugin", "subagents"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add alex2481kobe/claude-mods\nclaude plugin install agent-models@claude-mods"
added: "2026-10-05T01:57:24.200Z"
updated: "2026-10-28T09:20:42Z"
locale: "ko"
content_locale: "ko"
---

# agent-models

agent.spawn 훅을 사용해 기본 에이전트 목록의 각 서브에이전트 행에 실행 모델과 effort를 표시합니다.

## Description

agent-models는 Claude Code mods API 플러그인으로 서브에이전트가 시작되기 전에 작업 설명에 모델과 reasoning effort 라벨(예: Review auth · Opus 5.5 (high))을 붙입니다. Agent 도구의 model 옵션, .claude/agents/ 및 ~/.claude/agents/의 model:/effort: frontmatter 또는 부모 모델에서 값을 해석합니다. Explore와 Plan 같은 기본 에이전트 및 플러그인 에이전트에는 의도적으로 라벨을 붙이지 않고 알 수 없는 모델도 추측하지 않습니다. 설치: /plugin marketplace add alex2481kobe/claude-mods; /plugin install agent-models@claude-mods.

## Install

```
claude plugin marketplace add alex2481kobe/claude-mods
claude plugin install agent-models@claude-mods
```

## Original README

# agent-models

Each Claude subagent's model and effort in Claude Code's agent list.

![Two Claude subagents in the agent list, labelled Opus 5.5 (high) and Haiku](media/agent-list.png)

Claude Code's agent list shows a subagent's task but not what it runs on. With
this mod each row carries it, the way the codex mod's rows do:

```
Review auth · Opus 5.5 (high)
Check label.ts · Sonnet 5.5 (medium)
Say ok · Haiku
```

| The agent                                           | Its label                                         |
| --------------------------------------------------- | ------------------------------------------------- |
| `general-purpose`, a fork, an agent file's `inherit` | the parent's model and effort                     |
| an agent file with `model:` (and `effort:`)          | that model, and that effort                       |
| the Agent tool's `model` option                      | that model; the parent's effort only if the same model |
| Explore, Plan and other built-ins                    | none: their model is the engine's to choose       |
| a plugin's agent (`codex:read`)                      | none: the plugin labels its own                   |

Where the model cannot be known before the agent starts, the row is left as it
was rather than guessed.

## Requirements

- Claude Code with mods (tested on 2.1.287)

## Install

```
/plugin marketplace add alex2481kobe/claude-mods
/plugin install agent-models@claude-mods
```

## How it works

- An `agent.spawn` hook, which runs before the subagent starts, appends
  ` · <model> (<effort>)` to the task's description; the agent list shows that
  description.
- The model is the Agent tool's `model` option, else the agent file's, else the
  parent's for the agents that inherit it. Agent files are read from the
  project's `.claude/agents/` and your own (`~/.claude/agents/`, or
  `$CLAUDE_CONFIG_DIR/agents/`), matched by their `name`.
- The effort is the agent file's `effort`, else the effort of the parent's
  latest request, and that only when the agent runs on the parent's own model:
  another model may take no effort at all (Haiku takes none).
- Model ids read as people say them: `claude-opus-5-5` is `Opus 5.5`.

## Limits

- An agent file in a subfolder of `agents/`, or one defined in settings, a
  flag or policy, is not read, so its agent goes unlabelled.
- An agent file with no `model:` line is left unlabelled.
- An alias reads as its name without a version: `haiku` is `Haiku`.
- An agent file's `effort` is shown even when the Agent tool's `model` option
  overrides its model.
- Tried in the interactive terminal and headless (`claude -p`).
- The mods API is early access and may change between Claude Code releases.

## Develop

```sh
claude plugin validate plugins/agent-models
claude plugin test plugins/agent-models
claude --plugin-dir plugins/agent-models
```
