Claude Code 사용자 지정 에이전트 옵션 확인 - foliyo

확인일 2026년 09월 15일, @anthropic-ai/claude-code@2.1.271 버전과 도움말 확인

Claude Code 사용자 지정 에이전트 옵션 확인

Claude Code에서 사용자 지정 에이전트 정의는 루트 도움말의 --agents <json> 옵션으로 확인할 수 있습니다. 이 글은 옵션의 도움말 표시와 릴리스 노트에 나온 --agents 관련 항목까지만 다룹니다.

옵션 확인 방법

@anthropic-ai/claude-code@2.1.271의 루트 도움말에서 다음 옵션이 표시됐습니다.

  --agents <json>                       JSON object defining custom agents (e.g.
                                        '{"reviewer": {"description": "Reviews
                                        code", "prompt": "You are a code
                                        reviewer"}}')

도움말에는 --agents가 사용자 지정 에이전트를 정의하는 JSON 객체로 표시됩니다. 예시에는 reviewer 에이전트와 description, prompt 필드가 포함됩니다.

적용 범위

확인한 패키지 버전은 @anthropic-ai/claude-code@2.1.271이며, 실행 결과는 다음과 같습니다.

2.1.271 (Claude Code)

이 버전의 릴리스 노트에는 omitClaudeMd를 에이전트 frontmatter와 --agents JSON에서 사용할 수 있다고 적혀 있습니다. 사용자 지정 및 플러그인 하위 에이전트는 사용자, 프로젝트, 로컬 CLAUDE.md 파일 없이 실행할 수 있으며, 관리형 정책 파일은 계속 로드됩니다.

공식 릴리스 노트: anthropics/claude-code v2.1.271

---

함께 보면 좋은 글

• Claude Code restricted 모드 사용법, Bash와 외부 파일 접근 직접 확인
• Claude Code 2.1.259의 JSON, 재개 기능
• Claude Code 플러그인 폴더 옵션 확인