agnix로 CLAUDE.md·AGENTS.md 오류를 명령 한 줄로 잡고, 코덱스에는 서브에이전트 176개를 붙인다
에이전트 설정 파일을 검사하는 린터 agnix와 VoltAgent의 서브에이전트 모음을 소개한다. agnix는 클로드 코드와 코덱스가 함께 쓰는 설정 파일을 한 번에 검사한다. VoltAgent는 클로드 코드용 저장소와 코덱스용 저장소를 따로 운영해서, 두 도구의 설치법을 함께 정리했다.
1) agnix — 에이전트 설정 파일 린터
- 대상 에이전트: 공통(Claude Code·Codex CLI·Kiro·OpenCode·Cursor·Copilot 등)
- GitHub: agent-sh/agnix (https://github.com/agent-sh/agnix)
- 하는 일: 문법 오류와 규칙 위반을 찾는 린터다. CLAUDE.md, AGENTS.md, .codex/config.toml, 스킬(SKILL.md), 훅, MCP(모델 컨텍스트 프로토콜, 에이전트에 외부 도구를 붙이는 표준) 설정을 검사하고, 오류 일부는 자동으로 고친다.
- 규칙 수: 현재 README는 760개라고 적는다. 최신 릴리스는 v0.61.0이다. 버전이 바뀔 때마다 규칙이 늘어나니 릴리스 노트도 함께 보자.
설치와 기본 사용법
- npm(전 플랫폼): npm install -g agnix
- macOS·리눅스: brew tap agent-sh/agnix && brew install agnix
- 러스트 환경: cargo install agnix-cli
- 설치 없이 바로 실행: npx agnix .
- 현재 폴더 전체 검사: agnix .
- 안전한 수정만 자동 적용: agnix --fix .
코덱스 사용자가 볼 부분
- AGENTS.md 규칙(AGM-*, XP-*)은 AGENTS.md, AGENTS.local.md, AGENTS.override.md에 모두 적용된다.
- .codex/config.toml은 코덱스 전용 규칙(CDX-* 등)으로 검사한다.
활용 팁: CI에서 돌려라
- agnix --format github . 를 GitHub Actions에 넣으면 PR마다 검사 결과가 주석으로 붙는다. 팀원이 AGENTS.md를 고치다 규칙을 깨도 머지 전에 걸러낸다.
2) awesome-codex-subagents — 코덱스용 서브에이전트 176개
- 대상 에이전트: Codex(클로드 코드판은 따로 있다)
- GitHub: VoltAgent/awesome-codex-subagents (https://github.com/VoltAgent/awesome-codex-subagents)
- 하는 일: 특정 업무만 맡는 보조 에이전트인 서브에이전트를 TOML 파일로 모았다. README 기준 13개 분야에 176개 이상이 있고, 라이선스는 MIT다.
코덱스 설치 단계
- git clone https://github.com/VoltAgent/awesome-codex-subagents.git
- mkdir -p ~/.codex/agents
- 원하는 분야 폴더의 .toml 파일을 ~/.codex/agents/ 에 복사하면 모든 프로젝트에서 쓸 수 있다. 예: cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
- 특정 저장소에서만 쓰려면 프로젝트의 .codex/agents/ 에 넣는다. 이름이 겹치면 프로젝트 쪽이 전역 설정보다 우선한다.
코덱스는 이름을 불러야 움직인다
- 코덱스는 커스텀 서브에이전트를 자동으로 띄우지 않는다. 프롬프트에 서브에이전트 이름을 적어서 일을 직접 맡기자.
클로드 코드에서 같은 모음을 쓰는 법
- 저장소: VoltAgent/awesome-claude-code-subagents (https://github.com/VoltAgent/awesome-claude-code-subagents). README 기준 10개 분야에 161개 이상이 있다.
- 마켓플레이스 추가: claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
- 분야별 플러그인 설치: claude plugin install voltagent-lang (voltagent-infra, voltagent-qa-sec 등 분야마다 플러그인이 있다)
- 직접 설치하려면 .md 파일을 ~/.claude/agents/ 에 복사하거나, 저장소 루트의 ./install-agents.sh 를 실행해 대화형으로 골라 설치한다.
활용 팁: 필요한 분야만 깔아라
- 176개를 한꺼번에 넣으면 고르기만 어려워진다. 코드 리뷰나 보안처럼 자주 맡기는 분야 3~5개만 골라 프로젝트 .codex/agents/ 에 커밋하면, 팀 전체가 같은 서브에이전트를 쓴다.
오늘 할 일: npm install -g agnix 를 설치하고 저장소 루트에서 agnix . 를 한 번 돌려 AGENTS.md와 CLAUDE.md 경고부터 확인하자.
출처:
https://unpkg.com/[email protected]/README.md
https://lib.rs/crates/agnix-cli
https://awesome.ecosyste.ms/projects/github.com%2Fagent-sh%2Fagnix
https://discuss.pytorch.kr/t/awesome-codex-subagents-openai-codex-136-ai/9765
https://www.sourcepulse.org/projects/26443676
https://claudemarketplaces.com/plugins/voltagent-awesome-claude-code-subagents
https://codex.danielvaughan.com/2026/04/11/codex-cli-ecosystem-map-245-tools/
https://github.com/agent-sh/agnix
https://github.com/agent-sh/agnix/releases/latest
https://github.com/VoltAgent/awesome-codex-subagents
https://github.com/VoltAgent/awesome-claude-code-subagents
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록