Context7 CLI 설치 및 사용법

Context7은 최신 라이브러리 문서를 AI 코딩 어시스턴트의 컨텍스트에 직접 주입하여 오래된 학습 데이터를 기반으로 코드를 생성하는 것을 막는 플랫폼입니다. CLI(ctx7)는 npx ctx7으로 실행되며(설치 필요 없음) 단일 ctx7 setup 명령으로 Claude Code, Cursor 또는 OpenCode에 연결됩니다.

Context7이란 무엇이며 왜 중요한가요?

AI 코딩 도구를 사용하는 모든 개발자가 겪는 문제가 있습니다. 잘 아는 라이브러리를 사용하여 코드를 작성해달라고 어시스턴트에게 요청하면, 제대로 작동하는 것처럼 보이지만 더 이상 존재하지 않는 API를 사용하는 코드를 제공하는 경우입니다. 함수 시그니처가 틀렸습니다. 가져오기 경로는 두 주요 버전 전에 변경되었습니다. 예제는 버전 12 문서에서는 작동하지만, 실제로는 버전 15를 사용하고 있습니다.

이는 LLM이 특정 시점의 데이터로 학습되기 때문에 발생합니다. LLM은 지난달에 무엇이 변경되었는지 알지 못합니다. Next.js 15가 레이아웃 작동 방식을 어떻게 재작업했는지, 또는 학습 스냅샷 이후 의존하는 라이브러리가 API 표면의 절반을 더 이상 사용하지 않게 되었는지 모릅니다.

Context7이 이를 해결합니다. Upstash가 구축한 플랫폼으로, 9,000개 이상의 라이브러리 문서를 색인화하고 실시간으로 AI 어시스턴트에게 제공합니다. 코딩 에이전트에게 질문하면 Context7은 현재 버전별 문서를 가져와 모델이 응답을 생성하기 전에 컨텍스트 창에 배치합니다.

그 결과: AI 코딩 도구는 더 이상 존재하지 않는 API를 환각적으로 생성하는 것을 멈추고 라이브러리가 실제로 오늘날 하는 일과 일치하는 코드를 생성하기 시작합니다.

ctx7 CLI는 Context7의 명령줄 인터페이스입니다. 다음 세 가지 기능을 수행합니다.

터미널에서 직접 라이브러리 문서 가져오기
AI 코딩 스킬 관리 (에이전트를 향상시키는 재사용 가능한 프롬프트 파일)
Claude Code, Cursor 또는 OpenCode용 Context7 MCP 서버 구성

💡

개발 작업과 함께 API 통합을 구축하는 경우, Apidog가 API 테스트를 처리합니다. 이는 API 요청을 보내고, 구성하고, 자동화하기 위한 무료 클라이언트입니다. Context7은 AI 어시스턴트의 지식을 최신 상태로 유지하고, Apidog는 실제 API 호출을 검증합니다.

button

ctx7 설치

유일한 요구 사항은 Node.js 18 이상입니다. node --version으로 버전을 확인하세요.

설치 없이 실행

ctx7을 가장 빠르게 사용해보는 방법은 npx를 이용하는 것입니다.

npx ctx7 --help
npx ctx7 library react

이것은 실행할 때마다 최신 버전을 가져옵니다. 가끔 사용하는 경우에 좋습니다.

전역 설치

정기적으로 사용하려면 전역으로 설치하세요.

npm install -g ctx7
ctx7 --version

그 후에는 모든 ctx7 명령이 npx 오버헤드 없이 로컬에서 실행됩니다.

AI 코딩 에이전트를 위한 Context7 설정

ctx7 setup 명령은 Context7을 AI 코딩 환경에 연결합니다. OAuth를 통해 인증하고, API 키를 생성하며, 올바른 위치에 구성을 작성합니다.

대화형 설정

ctx7 setup

이것은 에이전트와 선호하는 모드(CLI + 스킬 vs. MCP)를 선택하라는 메시지를 표시합니다. 프롬프트를 건너뛰려면:

ctx7 setup --yes

특정 에이전트 지정

ctx7 setup --claude     # Claude Code (~/.claude/skills 또는 MCP 구성)
ctx7 setup --cursor     # Cursor (~/.cursor/skills 또는 MCP 구성)
ctx7 setup --opencode   # OpenCode

기존 API 키 사용

context7.com/dashboard에서 이미 Context7 API 키를 가지고 있다면:

ctx7 setup --api-key YOUR_API_KEY

프로젝트 수준 vs. 전역 설정

기본적으로 ctx7 setup은 전역으로 설치됩니다. 현재 프로젝트에만 구성하려면:

ctx7 setup --project

두 가지 모드: CLI + 스킬 vs. MCP

CLI + 스킬 모드는 AI 에이전트가 ctx7 CLI 명령을 실행하여 문서를 가져오도록 지시하는 SKILL.md 파일을 설치합니다. 에이전트는 스킬 지침을 읽고 라이브러리 문서가 필요할 때 ctx7 library 및 ctx7 docs를 자율적으로 실행합니다. MCP 서버가 필요하지 않습니다.

ctx7 setup --cli --claude    # ~/.claude/skills에 스킬 설치
ctx7 setup --cli --cursor    # ~/.cursor/skills에 스킬 설치
ctx7 setup --cli --universal # ~/.config/agents/skills에 설치

MCP 서버 모드는 Context7을 모델 컨텍스트 프로토콜 서버로 등록합니다. 에이전트는 CLI 명령을 실행하지 않고도 resolve-library-id 및 query-docs 도구를 기본적으로 호출합니다. 문서 가져오기는 사용자에게 보이지 않습니다.

MCP 모드의 경우, 구성은 다음과 같습니다 (에디터의 MCP 설정에 추가):

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "YOUR_API_KEY"
  }
}

또는 CLI를 통해 Claude Code에 추가:

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

인증

ctx7 login    # OAuth 브라우저 로그인
ctx7 whoami   # 로그인된 사용자 확인
ctx7 logout   # 저장된 자격 증명 제거

API 키를 환경 변수로 설정할 수도 있습니다:

export CONTEXT7_API_KEY=your_key_here

로그인은 스킬 생성 및 특정 설정 흐름에만 필요합니다. 기본 문서 조회는 로그인 없이 작동합니다.

텔레메트리

Context7은 기본적으로 익명 사용 데이터를 수집합니다. 비활성화하려면:

export CTX7_TELEMETRY_DISABLED=1

터미널에서 라이브러리 문서 가져오기

AI 에이전트가 개입하지 않아도 ctx7은 독립 실행형 문서 조회 도구로 유용합니다. 두 가지 명령이 중요한 작업을 수행합니다.

라이브러리 이름 확인

ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
ctx7 library express --json   # JSON 출력

이것은 Context7 색인을 검색하고 라이브러리의 정규 ID와 메타데이터(스니펫 수, 소스 평판, 벤치마크 점수, 버전 식별자)를 반환합니다.

ctx7 library nextjs의 예시 출력:

Library: /vercel/next.js
Snippets: 4,820
Reputation: high
Version: 15.2.0

문서 가져오기

라이브러리 ID를 알게 되면, 이를 주제 쿼리와 함께 ctx7 docs에 전달합니다.

ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"
ctx7 docs /facebook/react "hooks" --json

출력은 현재 라이브러리 버전에서 가져온 쿼리와 관련된 문서 스니펫입니다. 이 출력을 파일이나 다른 도구로 파이프할 수 있습니다.

라이브러리 ID를 이미 알고 있다면 ctx7 library를 건너뛰고 바로 ctx7 docs로 이동할 수 있습니다.

AI 코딩 스킬 관리

스킬은 AI 에이전트에게 전문 지식이나 동작을 제공하는 SKILL.md 파일입니다. 특정 유형의 작업을 처리하기 전에 에이전트가 읽는 작은 설명서라고 생각하면 됩니다.

Context7은 커뮤니티에서 기여한 스킬 레지스트리를 호스팅합니다. 검색하고, 에이전트 환경에 스킬을 설치하고, 사용자 정의 스킬을 생성하고, 필요 없는 것을 제거할 수 있습니다.

스킬 검색

ctx7 skills search pdf
ctx7 skills search "stripe payments"
ctx7 skills search "react testing"

스킬 설치

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor   # Cursor에만 설치
ctx7 skills install /anthropics/skills pdf --claude   # Claude Code에 설치

전역으로 설치하면 (--global), 스킬은 모든 프로젝트에서 사용할 수 있습니다.

ctx7 skills install /anthropics/skills pdf --global

프로젝트 기반 제안 받기

ctx7 skills suggest는 프로젝트 디렉토리를 스캔하고 사용하는 라이브러리 및 프레임워크를 감지하여 관련 스킬을 추천합니다.

ctx7 skills suggest

이는 새 프로젝트를 시작하고 관련 지식을 미리 에이전트에 시드하려는 경우에 잘 작동합니다.

설치된 스킬 목록

ctx7 skills list              # 모든 설치된 스킬
ctx7 skills list --claude     # Claude Code용으로 설치된 스킬만
ctx7 skills list --cursor     # Cursor 스킬만

스킬 제거

ctx7 skills remove pdf

AI로 사용자 정의 스킬 생성

이것은 가장 강력한 기능입니다. 유료 계정을 사용하면 Context7 색인에 있는 모든 라이브러리에서 사용자 정의 스킬을 생성할 수 있습니다.

ctx7 login
ctx7 skills generate

CLI는 대화형 프롬프트를 통해 안내합니다: 라이브러리를 선택하고, 스킬이 에이전트에게 가르치고 싶은 것을 설명하면, Context7이 해당 라이브러리의 현재 문서에 맞춰진 SKILL.md 파일을 생성합니다.

생성된 스킬은 휴대성이 좋습니다. SKILL.md 형식은 에이전트 스킬 표준을 따르므로, Claude Code용으로 생성한 스킬은 Cursor, VS Code Copilot, OpenCode 및 기타 에이전트 스킬 호환 도구에서 변경 없이 작동합니다.

무료 계정은 주당 6개의 스킬 생성이 가능합니다. 프로 계정은 주당 10개가 가능합니다.

빠른 타이핑을 위한 단축 별칭:

전체 명령	별칭
`ctx7 skills install`	`ctx7 si`
`ctx7 skills search`	`ctx7 ss`
`ctx7 skills generate`	`ctx7 skills gen` 또는 `ctx7 skills g`

AI 프롬프트에서 Context7 사용하기

Context7이 설정되면, 일상적인 코딩 워크플로에서 Context7을 사용하는 몇 가지 방법이 있습니다.

"use context7" 패턴

MCP 모드에서는 현재 문서가 필요한 모든 프롬프트에 "use context7"을 추가하세요.

유효한 JWT가 쿠키에 있는지 확인하고 인증되지 않은 사용자를 /login으로 리디렉션하는 Next.js 미들웨어를 생성합니다. use context7

사용자 및 게시물 모델과 일대다 관계를 사용하여 Prisma 스키마를 설정합니다. use context7

Next.js 15에서 앱 라우터 레이아웃을 어떻게 구성하나요? use context7

에이전트는 Context7의 resolve-library-id 및 query-docs 도구를 자동으로 호출하고, 현재 문서를 가져와 이를 기반으로 응답을 제공합니다.

특정 라이브러리 참조

프롬프트에 여러 라이브러리가 포함되어 있고 Context7이 하나에 집중하기를 원한다면:

Next.js 앱에서 Supabase 인증을 구현합니다.
Supabase용으로 /supabase/supabase 라이브러리를, Next.js 라우팅용으로 /vercel/next.js 라이브러리를 사용합니다.

이것은 라이브러리 매칭 단계를 건너뛰고 바로 문서로 이동합니다.

"use context7"을 입력하지 않고 자동 호출

라이브러리 코드를 다룰 때마다 자동으로 문서를 가져오도록 AI 에이전트에 규칙을 추가하세요. Claude Code에서는 CLAUDE.md에 다음을 추가하세요.

타사 라이브러리를 사용하는 코드를 생성할 때는 항상 Context7 MCP 도구를 사용합니다.
구현을 작성하기 전에 라이브러리 ID를 확인하고 현재 문서를 가져옵니다.
제가 요청하지 않아도 이 작업을 수행합니다.

Cursor에서는 Settings > Rules for AI에 다음을 추가하세요.

외부 라이브러리나 프레임워크를 사용하는 코드를 작성할 때는 항상 구현을 생성하기 전에
Context7을 호출하여 현재 문서를 가져옵니다.

완벽한 API 신뢰를 위해 Apidog와 함께 사용

Context7은 AI 어시스턴트의 라이브러리 지식을 최신 상태로 유지합니다. 하지만 정확한 문서는 그림의 절반에 불과합니다. API 통합을 구축할 때는 실제 HTTP 호출이 예상대로 작동하는지 확인해야 합니다.

Apidog가 이를 다룹니다. 요청을 보내고, 응답을 검사하고, 환경을 설정하고, 테스트 스위트를 자동화할 수 있는 무료 API 클라이언트입니다. 임시 엔드포인트 탐색부터 반복 가능한 통합 테스트까지 모든 것을 처리합니다.

실제 워크플로에서 이들이 서로를 보완하는 방법은 다음과 같습니다.

타사 API를 호출하는 Next.js 앱을 구축하는 경우. Context7은 AI 에이전트에게 최신 Next.js 문서를 제공하여 코드 제안이 정확하도록 합니다. Apidog를 사용하면 타사 API를 직접 테스트하고, 응답 구조를 확인하고, 코드가 보내는 페이로드가 API가 예상하는 것과 일치하는지 확인할 수 있습니다.
자체 HTTP API가 있는 새 라이브러리를 통합하는 경우. Context7은 에이전트에게 라이브러리의 현재 SDK 문서를 제공합니다. Apidog를 사용하면 애플리케이션 코드를 작성하기 전에 원시 API 엔드포인트를 테스트하여 HTTP 수준에서 동작을 이해할 수 있습니다.
통합을 디버깅하는 경우. Apidog에서 코드가 구성하는 정확한 요청을 보내고, 원시 응답을 검사하고, 문제가 요청 논리에 있는지 또는 API의 동작에 있는지 격리할 수 있습니다.

API 키를 변수로 저장하고 개발 환경과 프로덕션 환경을 한 번의 클릭으로 전환하며 모든 응답에 대해 테스트 어설션을 실행하는 Apidog 환경을 설정하세요. Context7 + Apidog는 최신 문서와 검증된 API 동작을 모두 제공합니다.

가격 및 속도 제한

ctx7 CLI는 무료로 사용할 수 있습니다. 속도 제한 및 기능 접근은 Context7 플랜에 따라 다릅니다.

플랜	가격	월별 API 호출 수	속도 제한	비공개 저장소
무료	$0	1,000	60회 요청/시간	아니요
프로	$7/시트/월	5,000/시트	60/시간/시트	예 ($15/1M 토큰 파싱)
엔터프라이즈	맞춤형	5,000/시트	맞춤형	예 ($25/1M 토큰)

무료 등급 참고 사항:

월별 한도에 도달하면 월이 재설정될 때까지 하루에 20개의 보너스 API 호출을 받습니다.
비공개 저장소 접근은 프로 이상이 필요합니다.
스킬 생성: 무료에서 주당 6개, 프로에서 주당 10개.
프로는 최대 20명의 멤버를 지원합니다.

중요한 제한 사항: Context7은 모든 쿼리를 Upstash 서버를 통해 라우팅합니다. 오프라인 모드는 없습니다. 인터넷 접근이 없는 환경에서는 도구가 작동하지 않습니다. 문서 응답은 클 수도 있으며, 이는 LLM의 컨텍스트 창을 소모합니다. 많은 라이브러리 쿼리가 있는 복잡한 프로젝트에서는 이것이 누적됩니다.

context7.com/dashboard에서 무료 API 키를 받으세요. API 키는 인증되지 않은 요청보다 더 높은 속도 제한을 제공합니다.

button

자주 묻는 질문

Context7이 내 코드를 서버로 보내나요?

아니요. 라이브러리 이름과 쿼리 텍스트만 Context7 서버로 전송되며, 코드는 물론 대화 기록이나 민감한 데이터는 전송되지 않습니다. 코드베이스는 LLM 제공업체에 남아 있습니다.

Context7은 어떤 라이브러리를 지원하나요?

색인에는 9,000개 이상의 공용 라이브러리 및 프레임워크가 포함되어 있습니다. context7.com에서 색인을 검색하여 특정 라이브러리를 사용할 수 있는지 확인할 수 있습니다. 새 라이브러리는 Context7 인터페이스의 /add-library를 통해 제출할 수 있습니다.

문서는 얼마나 최신인가요?

라이브러리는 주기적으로 재색인됩니다. 매우 최근에 출시된 버전(지난 며칠 내)은 아직 제공되지 않을 수 있습니다. 안정적인 라이브러리의 경우, 문서는 일반적으로 최신 릴리스와 일치합니다.

API 키 없이도 작동하나요?

기본 사용은 API 키 없이도 작동하지만 속도 제한이 낮습니다. 정기적으로 사용하려면 context7.com에 등록하고 CONTEXT7_API_KEY를 설정하여 더 나은 처리량을 얻으세요.

어떤 에디터와 에이전트를 지원하나요?

Context7은 Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop 및 MCP 또는 Agent Skills 표준을 지원하는 모든 클라이언트와 함께 작동합니다.

CLI + 스킬 모드와 MCP 모드의 차이점은 무엇인가요?

CLI + 스킬 모드에서는 스킬 파일이 에이전트에게 문서가 필요할 때 명시적으로 ctx7 명령을 실행하도록 지시합니다. MCP 모드에서는 에이전트가 MCP 프로토콜을 통해 Context7의 도구를 기본적으로 호출합니다. MCP 모드는 사용자에게 더 투명하며 일단 구성되면 명시적인 "use context7" 프롬프트가 필요하지 않습니다.

AI 코딩 에이전트 없이 ctx7을 사용할 수 있나요?

예. ctx7 library 및 ctx7 docs는 독립 실행형 터미널 명령으로 작동합니다. AI 에이전트 개입 없이 라이브러리 문서를 직접 조회할 수 있습니다.