TwelveLabs Claude Code 플러그인: CLI에서 비디오 검색하기

이제 소프트웨어 작업의 모든 영역에 비디오가 존재합니다. Zoom으로 녹화한 제품 데모, 내부 디자인 리뷰, 고객 콜, QA 재현 클립, 온보딩 가이드, 수시간 분량의 튜토리얼 등이 대표적입니다. 하지만 비디오가 엔지니어링의 "작업 대상(surface area)"이 되는 순간 고통스러운 현실에 부딪힙니다. 대부분의 개발자 도구는 여전히 비디오를 단순한 binary blob으로 취급하기 때문입니다. grep을 쓸 수도 없고, diff를 뜰 수도 없으며, 무슨 일이 일어났는지 물어볼 수도 없습니다.

지난해 저희는 TwelveLabs MCP 서버를 출시하며 이 현실을 바꿨습니다. 비디오 인덱싱, 시맨틱 검색, 분석, 임베딩을 모든 Model Context Protocol(MCP) 클라이언트가 호출할 수 있는 표준 도구로 공개한 것입니다. MCP 출시 포스트에서 설명했듯이, 이는 오픈 MCP 표준을 기반으로 구축되어 당사의 비디오 이해(video understanding) 플랫폼과 AI 어시스턴트를 이어주는 가교 역할을 합니다. 덕분에 AI 에이전트는 별도의 커스텀 글루 코드(glue code) 없이도 "비디오를 인덱싱하고, 관련 장면을 찾고, 요약본을 생성하는 등의 작업"을 수행할 수 있습니다.

오늘 저희는 터미널을 즐겨 쓰는 개발자들을 위한 다음 단계로 TwelveLabs Claude Code 플러그인을 선보입니다.

플러그인 소개

TwelveLabs Claude Code 플러그인은 비디오 인텔리전스를 여러분의 Claude Code 워크플로우에 통합합니다. 코드를 작성하느라 이미 띄워둔 CLI 대화창을 벗어날 필요 없이 비디오를 인덱싱, 검색, 분석, 임베딩할 수 있게 만듭니다.

Claude Code 플러그인 마켓플레이스를 통해 설치할 수 있으며, 인증에는 사용 중인 TWELVELABS_API_KEY를 사용합니다. 설치가 완료되면 MCP 서버가 연결될 뿐만 아니라 개발자들이 실제로 필요로 하는 UX 레이어(슬래시 명령어, 자연어 "스킬(skills)", 비동기 작업과 상태를 자동으로 추적하는 후크)가 구성됩니다.

범용 어댑터로서의 MCP라는 아이디어가 마음에 드셨다면, 이 플러그인은 "모든 기능이 내장된(batteries-included)" Claude Code 경험이라고 생각하시면 편합니다. 동일한 MCP 백본을 사용하면서 일상적인 터미널 워크플로우에 최적화된 결과물입니다.

실제 활용 방법

이 플러그인은 의도적으로 작고 가볍게 설계되었습니다. 레고 블록처럼 조합할 수 있는 몇 가지 동사(명령어)를 제공합니다. 인덱스(Index), 검색(Search), 분석(Analyze), 임베딩(Embed) 및 개체 검색(Entity search, 선택 사항)이 이에 해당합니다. 이를 통해 비디오를 대상으로 "먼저 grep하고, 그다음 설명하게 만드는" 듯한 깔끔한 워크플로우를 경험할 수 있습니다.

Index(인덱싱). 인덱싱은 로컬 경로, 원격 URL 또는 Google Drive 링크를 지원합니다. 또한 비동기(asynchronous) 방식으로 작동합니다. 인덱싱을 걸어두고 다시 코딩 작업을 하다가 필요할 때 상태를 확인하면 됩니다.

인덱싱이 완료되면 동일한 세션에서 해당 비디오를 검색하고 분석할 수 있게 됩니다.

Search(검색). 찾고자 하는 내용(시각적 요소, 동작, 소리, 화면상의 텍스트 등)을 설명하면 Claude Code가 관련 모먼트를 찾아 반환합니다. 이 플러그인은 이미지 검색, 복합(이미지 + 텍스트) 검색, 그리고 개체 검색(entity search)도 지원합니다.

개체 검색은 "이 인물이 등장하는 모든 순간을 찾아줘"와 같은 실무적인 요구를 해결해 줍니다. 개체 컬렉션을 만들고 참고용 이미지를 업로드 한 뒤 개체를 생성하면, 개체 ID(또는 @entity_id)로 쉽게 검색할 수 있습니다.

내부적으로 이와 같은 검색 경험을 구현하기 위해 TwelveLabs는 Marengo를 개발했습니다. Marengo는 텍스트, 이미지, 오디오, 비디오를 넘나드는 크로스 모달(cross-modal) 검색을 지원하는 "any-to-any" 검색 작업 전문 모델입니다.

Analyze(분석). 검색이 모먼트를 찾는 일에 가깝다면, 분석은 의미를 추출하는 일입니다. 이 플러그인은 요약, 주제 파악, Q&A, 후속 작업(action items) 도출 등 프롬프트로 기술할 수 있는 거의 모든 분석 작업을 지원합니다.

이처럼 비디오를 분석해 텍스트를 생성하는 능력은 Pegasus 모델의 핵심 강점입니다. 비디오 내의 시각 정보, 오디오 정보, 대화(speech) 정보를 통합해 텍스트를 생성하고 추론해 냅니다.

Embed(임베딩). 자체 검색 레이어, 클러스터링 파이프라인, 혹은 추천 시스템을 직접 구축 중이라면 비디오 임베딩을 곧바로 생성해 활용할 수 있습니다.

작동 원리

설계의 대원칙은 '개발자가 또 다른 도구를 배우게 만들지 말자'였습니다. 비디오를 에이전트가 처리할 수 있는 평범한 데이터 중 하나로 만드는 것이 핵심입니다.

기술적으로는 Claude Code → MCP 도구 → TwelveLabs로 매끄럽게 연결되는 체인을 구성합니다.

이 플러그인은 Claude Code의 플러그인 구조를 엄격히 따릅니다. 마켓플레이스 메타데이터용 매니페스트, 명령어(twelvelabs: 네임스페이스 하위의 슬래시 명령어), 스킬(자연어 트리거), 그리고 MCP 호출 전후로 실행되는 후크가 이에 해당합니다.

단순한 "API 래퍼(wrapper)"가 아닌 "CLI 네이티브"한 도구처럼 느껴지게 만드는 비밀은 후크와 상태 레이어에 있습니다. 후크는 결정론적인 JSON 규약으로 MCP 호출을 감싸며 (tool_name/tool_input을 읽고 continue/message를 반환), 입력값을 검증하고 결과값을 캐싱하여 비동기 작업의 일관성을 유지합니다.

로컬의 .twelvelabs/config.json은 보류 중인 인덱싱 작업, 완료된 비디오, 최근 결과 등을 추적하는 소형 런타임 캐시 역할을 합니다. 이 캐시는 여러 단계의 작업이 빠르게 연속으로 발생할 때 상태가 오염되는 것을 막기 위해 파일 잠금(file locking) 방식을 쓰는 헬퍼를 통해 관리됩니다.

스택의 가장 밑단에는 MCP 서버 자체가 위치합니다. 플러그인은 npx를 통해 실행되는 MCP 서버로 twelvelabs-mcp를 설정하며, 비디오 작업들은 mcp__twelvelabs-mcp__* 접두사를 사용한 MCP 도구 호출을 거쳐 처리됩니다.

구조적으로 이는 당사가 MCP 서버를 처음 출시할 때 공유해 드린 비전과 정확히 일치합니다. 비디오 이해 기능을 다른 시스템이 발견할 수 있는 "도구(tools)" 형태로 공개함으로써, MCP 호환 클라이언트라면 별도의 전용 연동 코드 없이도 이를 즉시 사용할 수 있도록 하는 것입니다.

Claude Code를 선택한 이유

저희는 독립적인 별도 앱을 만들지 않았습니다. 개발자들에게는 또 하나의 앱이 더 필요한 것이 아니기 때문입니다.

Claude Code는 이미 개발자들이 diff를 요약하고, 모듈을 리팩토링하고, 장애를 추적하고, 문서를 자동 생성하는 중심 공간입니다. 제품 데모, 고객 인터뷰, 사용자 세션 다시보기 등의 비디오 데이터가 동일한 워크플로우로 들어오는 순간, 여러분은 매끄럽게 이어지는 루프를 원하게 됩니다. 질문하고, 정확한 답변을 얻고, 후속 질문을 던진 뒤, 바로 코드를 수정해 반영하는 루프 말입니다.

이 플러그인은 해당 루프를 한 곳으로 모아줍니다. 명확하고 결정론적인 동작을 원할 때는 슬래시 명령어를 쓰고, 자유롭게 탐색(exploration)하고 싶을 때는 자연어를 쓰면 됩니다.

또한 플러그인이 MCP 서버, 명령어, 스킬, 후크를 자동으로 설정해 주기 때문에 "환경 변수 하나만 채워 넣으면 바로 작동할 준비"가 끝납니다.

시작하기

설치는 단 세 줄이면 충분합니다. (설치 후 플러그인과 MCP 서버가 제대로 적용되려면 Claude Code를 재시작해야 할 수도 있습니다.)

export TWELVELABS_API_KEY

TwelveLabs 서비스를 처음 이용하신다면 무료 플랜으로 시작하실 수 있습니다. 요금제 안내 페이지를 보시면 최대 10시간의 인덱싱, 600분 사용 한도 및 90일간의 인덱스 보존을 지원하며, 신용카드 등록 없이도 바로 시작할 수 있다고 명시되어 있습니다.

향후 계획

이번 첫 릴리즈는 본질적인 기능에 집중했습니다. 인덱싱, 멀티모달 검색(텍스트/이미지/개체), 분석, 임베딩을 개발자들이 매일 쓰는 워크플로우에 그대로 통합했습니다.

앞으로의 로드맵은 여러분의 실제 현업 워크플로우를 토대로 구체화될 것입니다. 플러그인을 사용하면서 겪은 불편한 경험(필요한 명령어가 없거나, 출력 형식의 아쉬움, 혹은 "이 단계를 한 번에 처리해 주면 좋겠는데" 싶은 순간 등)이 있다면 언제든 GitHub 저장소에 Issue나 PR을 열어주세요. 이 플러그인은 MIT 라이선스로 배포되며, 자유롭게 확장할 수 있도록 열려 있습니다.

플러그인 소개

TwelveLabs Claude Code 플러그인은 비디오 인텔리전스를 여러분의 Claude Code 워크플로우에 통합합니다. 코드를 작성하느라 이미 띄워둔 CLI 대화창을 벗어날 필요 없이 비디오를 인덱싱, 검색, 분석, 임베딩할 수 있게 만듭니다.

Claude Code 플러그인 마켓플레이스를 통해 설치할 수 있으며, 인증에는 사용 중인 TWELVELABS_API_KEY를 사용합니다. 설치가 완료되면 MCP 서버가 연결될 뿐만 아니라 개발자들이 실제로 필요로 하는 UX 레이어(슬래시 명령어, 자연어 "스킬(skills)", 비동기 작업과 상태를 자동으로 추적하는 후크)가 구성됩니다.

범용 어댑터로서의 MCP라는 아이디어가 마음에 드셨다면, 이 플러그인은 "모든 기능이 내장된(batteries-included)" Claude Code 경험이라고 생각하시면 편합니다. 동일한 MCP 백본을 사용하면서 일상적인 터미널 워크플로우에 최적화된 결과물입니다.

실제 활용 방법

이 플러그인은 의도적으로 작고 가볍게 설계되었습니다. 레고 블록처럼 조합할 수 있는 몇 가지 동사(명령어)를 제공합니다. 인덱스(Index), 검색(Search), 분석(Analyze), 임베딩(Embed) 및 개체 검색(Entity search, 선택 사항)이 이에 해당합니다. 이를 통해 비디오를 대상으로 "먼저 grep하고, 그다음 설명하게 만드는" 듯한 깔끔한 워크플로우를 경험할 수 있습니다.

Index(인덱싱). 인덱싱은 로컬 경로, 원격 URL 또는 Google Drive 링크를 지원합니다. 또한 비동기(asynchronous) 방식으로 작동합니다. 인덱싱을 걸어두고 다시 코딩 작업을 하다가 필요할 때 상태를 확인하면 됩니다.

인덱싱이 완료되면 동일한 세션에서 해당 비디오를 검색하고 분석할 수 있게 됩니다.

Search(검색). 찾고자 하는 내용(시각적 요소, 동작, 소리, 화면상의 텍스트 등)을 설명하면 Claude Code가 관련 모먼트를 찾아 반환합니다. 이 플러그인은 이미지 검색, 복합(이미지 + 텍스트) 검색, 그리고 개체 검색(entity search)도 지원합니다.

개체 검색은 "이 인물이 등장하는 모든 순간을 찾아줘"와 같은 실무적인 요구를 해결해 줍니다. 개체 컬렉션을 만들고 참고용 이미지를 업로드 한 뒤 개체를 생성하면, 개체 ID(또는 @entity_id)로 쉽게 검색할 수 있습니다.

내부적으로 이와 같은 검색 경험을 구현하기 위해 TwelveLabs는 Marengo를 개발했습니다. Marengo는 텍스트, 이미지, 오디오, 비디오를 넘나드는 크로스 모달(cross-modal) 검색을 지원하는 "any-to-any" 검색 작업 전문 모델입니다.

Analyze(분석). 검색이 모먼트를 찾는 일에 가깝다면, 분석은 의미를 추출하는 일입니다. 이 플러그인은 요약, 주제 파악, Q&A, 후속 작업(action items) 도출 등 프롬프트로 기술할 수 있는 거의 모든 분석 작업을 지원합니다.

이처럼 비디오를 분석해 텍스트를 생성하는 능력은 Pegasus 모델의 핵심 강점입니다. 비디오 내의 시각 정보, 오디오 정보, 대화(speech) 정보를 통합해 텍스트를 생성하고 추론해 냅니다.

Embed(임베딩). 자체 검색 레이어, 클러스터링 파이프라인, 혹은 추천 시스템을 직접 구축 중이라면 비디오 임베딩을 곧바로 생성해 활용할 수 있습니다.

작동 원리

설계의 대원칙은 '개발자가 또 다른 도구를 배우게 만들지 말자'였습니다. 비디오를 에이전트가 처리할 수 있는 평범한 데이터 중 하나로 만드는 것이 핵심입니다.

기술적으로는 Claude Code → MCP 도구 → TwelveLabs로 매끄럽게 연결되는 체인을 구성합니다.

이 플러그인은 Claude Code의 플러그인 구조를 엄격히 따릅니다. 마켓플레이스 메타데이터용 매니페스트, 명령어(twelvelabs: 네임스페이스 하위의 슬래시 명령어), 스킬(자연어 트리거), 그리고 MCP 호출 전후로 실행되는 후크가 이에 해당합니다.

단순한 "API 래퍼(wrapper)"가 아닌 "CLI 네이티브"한 도구처럼 느껴지게 만드는 비밀은 후크와 상태 레이어에 있습니다. 후크는 결정론적인 JSON 규약으로 MCP 호출을 감싸며 (tool_name/tool_input을 읽고 continue/message를 반환), 입력값을 검증하고 결과값을 캐싱하여 비동기 작업의 일관성을 유지합니다.

로컬의 .twelvelabs/config.json은 보류 중인 인덱싱 작업, 완료된 비디오, 최근 결과 등을 추적하는 소형 런타임 캐시 역할을 합니다. 이 캐시는 여러 단계의 작업이 빠르게 연속으로 발생할 때 상태가 오염되는 것을 막기 위해 파일 잠금(file locking) 방식을 쓰는 헬퍼를 통해 관리됩니다.

스택의 가장 밑단에는 MCP 서버 자체가 위치합니다. 플러그인은 npx를 통해 실행되는 MCP 서버로 twelvelabs-mcp를 설정하며, 비디오 작업들은 mcp__twelvelabs-mcp__* 접두사를 사용한 MCP 도구 호출을 거쳐 처리됩니다.

구조적으로 이는 당사가 MCP 서버를 처음 출시할 때 공유해 드린 비전과 정확히 일치합니다. 비디오 이해 기능을 다른 시스템이 발견할 수 있는 "도구(tools)" 형태로 공개함으로써, MCP 호환 클라이언트라면 별도의 전용 연동 코드 없이도 이를 즉시 사용할 수 있도록 하는 것입니다.

Claude Code를 선택한 이유

저희는 독립적인 별도 앱을 만들지 않았습니다. 개발자들에게는 또 하나의 앱이 더 필요한 것이 아니기 때문입니다.

Claude Code는 이미 개발자들이 diff를 요약하고, 모듈을 리팩토링하고, 장애를 추적하고, 문서를 자동 생성하는 중심 공간입니다. 제품 데모, 고객 인터뷰, 사용자 세션 다시보기 등의 비디오 데이터가 동일한 워크플로우로 들어오는 순간, 여러분은 매끄럽게 이어지는 루프를 원하게 됩니다. 질문하고, 정확한 답변을 얻고, 후속 질문을 던진 뒤, 바로 코드를 수정해 반영하는 루프 말입니다.

이 플러그인은 해당 루프를 한 곳으로 모아줍니다. 명확하고 결정론적인 동작을 원할 때는 슬래시 명령어를 쓰고, 자유롭게 탐색(exploration)하고 싶을 때는 자연어를 쓰면 됩니다.

또한 플러그인이 MCP 서버, 명령어, 스킬, 후크를 자동으로 설정해 주기 때문에 "환경 변수 하나만 채워 넣으면 바로 작동할 준비"가 끝납니다.

시작하기

설치는 단 세 줄이면 충분합니다. (설치 후 플러그인과 MCP 서버가 제대로 적용되려면 Claude Code를 재시작해야 할 수도 있습니다.)

export TWELVELABS_API_KEY

TwelveLabs 서비스를 처음 이용하신다면 무료 플랜으로 시작하실 수 있습니다. 요금제 안내 페이지를 보시면 최대 10시간의 인덱싱, 600분 사용 한도 및 90일간의 인덱스 보존을 지원하며, 신용카드 등록 없이도 바로 시작할 수 있다고 명시되어 있습니다.

향후 계획

이번 첫 릴리즈는 본질적인 기능에 집중했습니다. 인덱싱, 멀티모달 검색(텍스트/이미지/개체), 분석, 임베딩을 개발자들이 매일 쓰는 워크플로우에 그대로 통합했습니다.

앞으로의 로드맵은 여러분의 실제 현업 워크플로우를 토대로 구체화될 것입니다. 플러그인을 사용하면서 겪은 불편한 경험(필요한 명령어가 없거나, 출력 형식의 아쉬움, 혹은 "이 단계를 한 번에 처리해 주면 좋겠는데" 싶은 순간 등)이 있다면 언제든 GitHub 저장소에 Issue나 PR을 열어주세요. 이 플러그인은 MIT 라이선스로 배포되며, 자유롭게 확장할 수 있도록 열려 있습니다.

플러그인 소개

TwelveLabs Claude Code 플러그인은 비디오 인텔리전스를 여러분의 Claude Code 워크플로우에 통합합니다. 코드를 작성하느라 이미 띄워둔 CLI 대화창을 벗어날 필요 없이 비디오를 인덱싱, 검색, 분석, 임베딩할 수 있게 만듭니다.

Claude Code 플러그인 마켓플레이스를 통해 설치할 수 있으며, 인증에는 사용 중인 TWELVELABS_API_KEY를 사용합니다. 설치가 완료되면 MCP 서버가 연결될 뿐만 아니라 개발자들이 실제로 필요로 하는 UX 레이어(슬래시 명령어, 자연어 "스킬(skills)", 비동기 작업과 상태를 자동으로 추적하는 후크)가 구성됩니다.

범용 어댑터로서의 MCP라는 아이디어가 마음에 드셨다면, 이 플러그인은 "모든 기능이 내장된(batteries-included)" Claude Code 경험이라고 생각하시면 편합니다. 동일한 MCP 백본을 사용하면서 일상적인 터미널 워크플로우에 최적화된 결과물입니다.

실제 활용 방법

이 플러그인은 의도적으로 작고 가볍게 설계되었습니다. 레고 블록처럼 조합할 수 있는 몇 가지 동사(명령어)를 제공합니다. 인덱스(Index), 검색(Search), 분석(Analyze), 임베딩(Embed) 및 개체 검색(Entity search, 선택 사항)이 이에 해당합니다. 이를 통해 비디오를 대상으로 "먼저 grep하고, 그다음 설명하게 만드는" 듯한 깔끔한 워크플로우를 경험할 수 있습니다.

Index(인덱싱). 인덱싱은 로컬 경로, 원격 URL 또는 Google Drive 링크를 지원합니다. 또한 비동기(asynchronous) 방식으로 작동합니다. 인덱싱을 걸어두고 다시 코딩 작업을 하다가 필요할 때 상태를 확인하면 됩니다.

인덱싱이 완료되면 동일한 세션에서 해당 비디오를 검색하고 분석할 수 있게 됩니다.

Search(검색). 찾고자 하는 내용(시각적 요소, 동작, 소리, 화면상의 텍스트 등)을 설명하면 Claude Code가 관련 모먼트를 찾아 반환합니다. 이 플러그인은 이미지 검색, 복합(이미지 + 텍스트) 검색, 그리고 개체 검색(entity search)도 지원합니다.

개체 검색은 "이 인물이 등장하는 모든 순간을 찾아줘"와 같은 실무적인 요구를 해결해 줍니다. 개체 컬렉션을 만들고 참고용 이미지를 업로드 한 뒤 개체를 생성하면, 개체 ID(또는 @entity_id)로 쉽게 검색할 수 있습니다.

내부적으로 이와 같은 검색 경험을 구현하기 위해 TwelveLabs는 Marengo를 개발했습니다. Marengo는 텍스트, 이미지, 오디오, 비디오를 넘나드는 크로스 모달(cross-modal) 검색을 지원하는 "any-to-any" 검색 작업 전문 모델입니다.

Analyze(분석). 검색이 모먼트를 찾는 일에 가깝다면, 분석은 의미를 추출하는 일입니다. 이 플러그인은 요약, 주제 파악, Q&A, 후속 작업(action items) 도출 등 프롬프트로 기술할 수 있는 거의 모든 분석 작업을 지원합니다.

이처럼 비디오를 분석해 텍스트를 생성하는 능력은 Pegasus 모델의 핵심 강점입니다. 비디오 내의 시각 정보, 오디오 정보, 대화(speech) 정보를 통합해 텍스트를 생성하고 추론해 냅니다.

Embed(임베딩). 자체 검색 레이어, 클러스터링 파이프라인, 혹은 추천 시스템을 직접 구축 중이라면 비디오 임베딩을 곧바로 생성해 활용할 수 있습니다.

작동 원리

설계의 대원칙은 '개발자가 또 다른 도구를 배우게 만들지 말자'였습니다. 비디오를 에이전트가 처리할 수 있는 평범한 데이터 중 하나로 만드는 것이 핵심입니다.

기술적으로는 Claude Code → MCP 도구 → TwelveLabs로 매끄럽게 연결되는 체인을 구성합니다.

이 플러그인은 Claude Code의 플러그인 구조를 엄격히 따릅니다. 마켓플레이스 메타데이터용 매니페스트, 명령어(twelvelabs: 네임스페이스 하위의 슬래시 명령어), 스킬(자연어 트리거), 그리고 MCP 호출 전후로 실행되는 후크가 이에 해당합니다.

단순한 "API 래퍼(wrapper)"가 아닌 "CLI 네이티브"한 도구처럼 느껴지게 만드는 비밀은 후크와 상태 레이어에 있습니다. 후크는 결정론적인 JSON 규약으로 MCP 호출을 감싸며 (tool_name/tool_input을 읽고 continue/message를 반환), 입력값을 검증하고 결과값을 캐싱하여 비동기 작업의 일관성을 유지합니다.

로컬의 .twelvelabs/config.json은 보류 중인 인덱싱 작업, 완료된 비디오, 최근 결과 등을 추적하는 소형 런타임 캐시 역할을 합니다. 이 캐시는 여러 단계의 작업이 빠르게 연속으로 발생할 때 상태가 오염되는 것을 막기 위해 파일 잠금(file locking) 방식을 쓰는 헬퍼를 통해 관리됩니다.

스택의 가장 밑단에는 MCP 서버 자체가 위치합니다. 플러그인은 npx를 통해 실행되는 MCP 서버로 twelvelabs-mcp를 설정하며, 비디오 작업들은 mcp__twelvelabs-mcp__* 접두사를 사용한 MCP 도구 호출을 거쳐 처리됩니다.

구조적으로 이는 당사가 MCP 서버를 처음 출시할 때 공유해 드린 비전과 정확히 일치합니다. 비디오 이해 기능을 다른 시스템이 발견할 수 있는 "도구(tools)" 형태로 공개함으로써, MCP 호환 클라이언트라면 별도의 전용 연동 코드 없이도 이를 즉시 사용할 수 있도록 하는 것입니다.

Claude Code를 선택한 이유

저희는 독립적인 별도 앱을 만들지 않았습니다. 개발자들에게는 또 하나의 앱이 더 필요한 것이 아니기 때문입니다.

Claude Code는 이미 개발자들이 diff를 요약하고, 모듈을 리팩토링하고, 장애를 추적하고, 문서를 자동 생성하는 중심 공간입니다. 제품 데모, 고객 인터뷰, 사용자 세션 다시보기 등의 비디오 데이터가 동일한 워크플로우로 들어오는 순간, 여러분은 매끄럽게 이어지는 루프를 원하게 됩니다. 질문하고, 정확한 답변을 얻고, 후속 질문을 던진 뒤, 바로 코드를 수정해 반영하는 루프 말입니다.

이 플러그인은 해당 루프를 한 곳으로 모아줍니다. 명확하고 결정론적인 동작을 원할 때는 슬래시 명령어를 쓰고, 자유롭게 탐색(exploration)하고 싶을 때는 자연어를 쓰면 됩니다.

또한 플러그인이 MCP 서버, 명령어, 스킬, 후크를 자동으로 설정해 주기 때문에 "환경 변수 하나만 채워 넣으면 바로 작동할 준비"가 끝납니다.

시작하기

설치는 단 세 줄이면 충분합니다. (설치 후 플러그인과 MCP 서버가 제대로 적용되려면 Claude Code를 재시작해야 할 수도 있습니다.)

export TWELVELABS_API_KEY

TwelveLabs 서비스를 처음 이용하신다면 무료 플랜으로 시작하실 수 있습니다. 요금제 안내 페이지를 보시면 최대 10시간의 인덱싱, 600분 사용 한도 및 90일간의 인덱스 보존을 지원하며, 신용카드 등록 없이도 바로 시작할 수 있다고 명시되어 있습니다.

향후 계획

이번 첫 릴리즈는 본질적인 기능에 집중했습니다. 인덱싱, 멀티모달 검색(텍스트/이미지/개체), 분석, 임베딩을 개발자들이 매일 쓰는 워크플로우에 그대로 통합했습니다.

앞으로의 로드맵은 여러분의 실제 현업 워크플로우를 토대로 구체화될 것입니다. 플러그인을 사용하면서 겪은 불편한 경험(필요한 명령어가 없거나, 출력 형식의 아쉬움, 혹은 "이 단계를 한 번에 처리해 주면 좋겠는데" 싶은 순간 등)이 있다면 언제든 GitHub 저장소에 Issue나 PR을 열어주세요. 이 플러그인은 MIT 라이선스로 배포되며, 자유롭게 확장할 수 있도록 열려 있습니다.