이제 '코딩 보조 도구' 프레임은 버려라
OpenAI가 Codex에 플러그인 기능을 출시했다. Slack·Gmail·Figma·Notion·GitHub·Linear까지—개발자가 이미 쓰는 협업 도구 대부분이 즉시 연동된다. 단순 코드 자동완성을 기대했다면 이 업데이트는 그 기대를 완전히 벗어난다. Codex는 이제 기획 리서치부터 PR 트리아지, 디자인-to-코드, 배포까지 커버하는 '개발 전 스택 에이전트'를 표방한다. aitimes 보도에 따르면 Codex 주간 활성 사용자는 이미 160만 명을 넘었고, 윈도우 버전 출시와 함께 기업 시장 공략도 가속 중이다.
경쟁 구도도 명확해졌다. Anthropic의 Claude Code가 .claude/ 폴더 기반의 프로젝트 내재화 전략을 앞세우는 반면, OpenAI는 플러그인 마켓플레이스라는 생태계 확장으로 맞선다. Google도 Gemini CLI에 Extensions를 붙이며 합류했다. 셋 모두 MCP(Model Context Protocol) 서버를 공통 인프라로 채택한 상태다. 표준화 경쟁이 아니라 사실상 MCP 위에서의 생태계 경쟁이다.
Codex 플러그인의 실질적 구조: 무엇이 다른가
Codex 플러그인은 Skills + Apps + MCP 서버 세 가지를 하나의 설치형 번들로 묶는다. Skills는 Codex가 특정 상황에서 어떤 절차를 따를지 정의하는 자연어 지침 단위다. 방화벽 설정 스크립트를 한 번 등록하면 매번 새로 생성할 필요 없이 자동 실행된다. 오류 가능성과 연산 비용이 동시에 줄어든다.
팀 도입 관점에서 핵심은 재사용성과 표준화다. 동일한 플러그인이 Codex 앱·CLI·IDE 확장 환경 모두에서 작동하므로, 팀원마다 제각각인 워크플로우를 하나의 번들로 통일할 수 있다. OpenAI는 이미 20개 이상의 공식 플러그인 디렉터리를 공개했고, 향후 사용자 배포 마켓플레이스도 예고했다. geeknews 정리에 따르면 현재 Featured 플러그인만 해도 GitHub·Slack·Notion·Linear·Figma·Vercel·Netlify까지 커버한다.
Claude Code .claude/ 폴더: 코드베이스에 박힌 팀의 규칙
Claude Code의 접근은 다르다. .claude/ 폴더는 프로젝트 레포 안에 직접 자리잡는 제어 디렉터리다. CLAUDE.md는 Claude가 세션 시작마다 가장 먼저 읽는 파일로, 빌드 명령·아키텍처 결정·네이밍 규칙·에러 처리 방침이 여기에 담긴다. commands/ 폴더의 마크다운 파일은 슬래시 명령으로 등록되고, skills/는 대화 맥락을 분석해 자동 트리거되며, agents/는 code-reviewer나 security-auditor 같은 역할 전문 서브에이전트를 정의한다. settings.json은 Bash(rm -rf *) 같은 위험 명령을 완전 차단하는 권한 경계선이다.
결정적 차이는 Git에 커밋된다는 점이다. 팀이 합의한 AI 행동 규칙이 코드베이스와 함께 버전 관리된다. 신규 팀원이 레포를 클론하면 AI 워크플로우 설정도 함께 받는다. 온보딩 비용이 구조적으로 줄어드는 설계다.
테크 리드가 지금 당장 따져봐야 할 선택 기준
솔직히 말하면, 두 도구는 경쟁 관계라기보다 투입 시점이 다른 레이어다.
Codex 플러그인이 유리한 상황: - Slack·Figma·Notion 등 외부 협업 도구와의 연동이 워크플로우 핵심인 팀 - 기획·리서치·디자인 리뷰까지 AI가 개입해야 하는 풀스택 에이전트 니즈 - 팀 표준 플러그인을 마켓플레이스에서 가져다 빠르게 배포하고 싶을 때 - 로컬 셋업 부담 없이 SaaS형으로 즉시 시작하고 싶을 때
Claude Code .claude/ 폴더가 유리한 상황: - 코드베이스 내 규칙을 팀 전체가 Git으로 공유해야 하는 경우 - AI의 행동 범위를 프로젝트별로 세밀하게 제어해야 하는 경우 - 보안팀이 AI의 파일 접근·명령 실행 권한에 민감한 엔터프라이즈 환경 - 서브에이전트(code-reviewer, security-auditor)를 역할 단위로 분리 운용하고 싶을 때
현장에서 터지는 진짜 문제들
geeknews 해커뉴스 커뮤니티 반응에서 실용적인 경고가 나온다. 몇 가지는 팀 도입 전 반드시 짚어야 한다.
첫째, 오버 설정 함정이다. CLAUDE.md나 플러그인 Skills를 과도하게 쌓으면 오히려 AI 성능이 저하된다. 모델이 지속적으로 개선되면서 예전에 필요했던 지시문이 이제는 방해가 된다는 경험담도 나온다. CLAUDE.md는 200줄 이하 유지가 권장되고, 처음엔 빈 파일로 시작해 팀의 실제 마찰에서 규칙을 추가하는 방식이 낫다.
둘째, 에이전트 모드의 보안 경계다. settings.json의 deny 리스트가 일반 사용에선 충분하지만, 에이전트 자율 실행 모드에서는 Bash 접근을 통한 우회 가능성이 남는다. MCP 서버 연동이 늘어날수록 자격증명 노출 위험도 함께 커진다.
셋째, 컨텍스트 누적과 초기화 타이밍이다. 세션마다 컨텍스트가 쌓이면 성능이 저하된다. 계획 단계와 실행 단계를 분리하고 컨텍스트를 주기적으로 초기화하는 운용 규칙이 필요하다.
팀 도입 전략: 작게 시작하고 구조로 확장한다
두 도구 모두 처음부터 완성된 설정을 구축하려다 실패하는 패턴이 반복된다. 실전에서 작동하는 순서는 하나다.
- 최소 설정으로 시작: Codex는 Featured 플러그인 1~2개만, Claude Code는
/init으로 기본CLAUDE.md생성 후 팀 핵심 규칙 10줄만 넣는다. - 마찰 지점에서 규칙 추가: 팀원이 같은 지시를 반복하게 되는 순간이 Skills나 commands를 추가할 타이밍이다.
- Git으로 공유: Claude Code의
.claude/폴더는 커밋하고, Codex 플러그인은 팀 마켓플레이스로 배포한다. AI 워크플로우가 코드베이스의 일부가 되는 순간 온보딩이 달라진다. - 권한 경계 먼저 그린다:
settings.json의 deny 리스트, MCP 서버 자격증명 관리는 첫날 설정한다. 나중에 고치려면 팀 전체가 멈춰야 한다.
전망: 에이전트 표준화 전쟁의 진짜 승부처
OpenAI·Anthropic·Google이 모두 MCP를 공통 기반으로 채택한 건 우연이 아니다. 에이전트 간 인터페이스가 표준화되면 도구 교체 비용이 낮아지고, 결국 승부는 생태계의 깊이와 팀의 학습 곡선으로 이동한다. Codex 플러그인 마켓플레이스가 Claude Code의 커뮤니티 Skills 생태계보다 빠르게 커질 수도 있고, 반대로 Git 기반의 코드베이스 내재화라는 Claude Code의 구조적 강점이 엔터프라이즈 시장을 잡을 수도 있다.
테크 리드 입장에서 지금 해야 할 판단은 단순하다. 어떤 도구가 더 좋은가가 아니라, 우리 팀의 마찰이 어디서 나오는가를 먼저 진단하는 것이다. 협업 도구 연동이 병목이면 Codex 플러그인, 코드베이스 규칙 공유와 AI 권한 제어가 병목이면 Claude Code .claude/ 폴더부터 손댄다. 그리고 둘은 동시에 쓸 수 있다.