DEV Community

Cover image for Como instalar e usar o Context7 CLI: Guia completo
Lucas
Lucas

Posted on • Originally published at apidog.com

Como instalar e usar o Context7 CLI: Guia completo

Context7 é uma plataforma que injeta documentação de biblioteca atualizada diretamente no contexto do seu assistente de codificação de IA, eliminando problemas de código gerado com base em informações desatualizadas. Use a CLI (ctx7) com npx ctx7 (sem necessidade de instalação) e conecte rapidamente ao Claude Code, Cursor ou OpenCode usando ctx7 setup.

Experimente o Apidog hoje

O que é Context7 e por que usar na sua stack?

Quando seu assistente de IA gera código com APIs obsoletas ou exemplos inválidos, normalmente é porque foi treinado em dados antigos. O Context7 corrige isso indexando e servindo a documentação atualizada (por versão) de mais de 9.000 bibliotecas diretamente ao seu agente de IA.

Funciona assim: ao fazer uma pergunta, o Context7 busca a documentação correta e a insere como contexto antes do LLM responder. Isso reduz drasticamente erros de API e código quebrado.

A CLI ctx7 oferece:

  1. Busca de documentação de biblioteca no terminal
  2. Gerenciamento de habilidades de IA (prompts reutilizáveis para seu agente)
  3. Configuração do servidor MCP para integração nativa com Claude Code, Cursor ou OpenCode

💡 Se você também testa integrações de API, o Apidog facilita testes, organização e automação de requisições. Use Context7 para manter seu agente de IA atualizado e o Apidog para garantir que suas chamadas API realmente funcionam.

Instalando ctx7

Pré-requisito: Node.js 18+. Verifique com:

node --version
Enter fullscreen mode Exit fullscreen mode

Executar sem instalar

Rode diretamente com npx:

npx ctx7 --help
npx ctx7 library react
Enter fullscreen mode Exit fullscreen mode

Sempre baixa a versão mais recente — ideal para uso pontual.

Instalar globalmente

Para uso frequente, instale globalmente:

npm install -g ctx7
ctx7 --version
Enter fullscreen mode Exit fullscreen mode

Com isso, ctx7 roda localmente, sem o overhead do npx.

Configurando Context7 para seu agente de IA

Conecte o Context7 ao seu ambiente de IA com:

ctx7 setup
Enter fullscreen mode Exit fullscreen mode

Esse comando faz autenticação via OAuth, gera chave de API e salva a configuração.

Configuração interativa

Rode:

ctx7 setup
Enter fullscreen mode Exit fullscreen mode

Siga os prompts para escolher agente e modo. Para automatizar:

ctx7 setup --yes
Enter fullscreen mode Exit fullscreen mode

Apontar para um agente específico 

ctx7 setup --claude     # Claude Code (~/.claude/skills ou MCP)
ctx7 setup --cursor     # Cursor (~/.cursor/skills ou MCP)
ctx7 setup --opencode   # OpenCode
Enter fullscreen mode Exit fullscreen mode

Usar uma chave de API existente

Se já tem uma chave em context7.com/dashboard:

ctx7 setup --api-key SUA_CHAVE_DE_API
Enter fullscreen mode Exit fullscreen mode

Configuração por projeto

Por padrão, ctx7 setup é global. Para configurar no projeto atual:

ctx7 setup --project
Enter fullscreen mode Exit fullscreen mode

Modos: CLI + Habilidades vs MCP

CLI + Habilidades: Instala um SKILL.md para o agente de IA executar comandos ctx7 automaticamente.

ctx7 setup --cli --claude
ctx7 setup --cli --cursor
ctx7 setup --cli --universal
Enter fullscreen mode Exit fullscreen mode

Servidor MCP: Integra direto via protocolo MCP, tornando o uso do Context7 transparente.

No editor, adicione às configurações MCP:

{
  "url": "https://mcp.context7.com/mcp",
  "headers": {
    "CONTEXT7_API_KEY": "SUA_CHAVE_DE_API"
  }
}
Enter fullscreen mode Exit fullscreen mode

Ou via CLI no Claude Code:

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key SUA_CHAVE_DE_API
Enter fullscreen mode Exit fullscreen mode

Autenticação 

ctx7 login    # Login OAuth
ctx7 whoami   # Ver usuário logado
ctx7 logout   # Remover credenciais
Enter fullscreen mode Exit fullscreen mode

Ou configure a variável de ambiente:

export CONTEXT7_API_KEY=sua_chave_aqui
Enter fullscreen mode Exit fullscreen mode

Login só é necessário para geração de habilidades e certas configurações. Busca de documentação básica não exige login.

Telemetria

Desative telemetria se preferir:

export CTX7_TELEMETRY_DISABLED=1
Enter fullscreen mode Exit fullscreen mode

Buscando documentação da biblioteca no terminal

Mesmo sem um agente de IA, ctx7 serve como buscador de docs.

Resolver nome de biblioteca 

ctx7 library react
ctx7 library nextjs "configuração do app router"
ctx7 library prisma "relações de banco de dados"
ctx7 library express --json
Enter fullscreen mode Exit fullscreen mode

Exemplo de saída:

Biblioteca: /vercel/next.js
Trechos: 4.820
Reputação: alta
Versão: 15.2.0
Enter fullscreen mode Exit fullscreen mode

Buscar documentação

Com o ID da biblioteca:

ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "autenticação middleware"
ctx7 docs /prisma/prisma "relações um-para-muitos"
ctx7 docs /facebook/react "hooks" --json
Enter fullscreen mode Exit fullscreen mode

A saída são trechos relevantes da doc, extraídos da versão atual.

Dica: se já sabe o ID, pode ir direto para ctx7 docs.

Gerenciando habilidades de codificação de IA

Habilidades (SKILL.md) são instruções ou conhecimentos extras para o agente de IA. Com Context7 você pode:

  • Pesquisar o registro de habilidades
  • Instalar habilidades no seu agente
  • Gerar habilidades personalizadas
  • Remover habilidades

Pesquisar habilidades 

ctx7 skills search pdf
ctx7 skills search "pagamentos stripe"
ctx7 skills search "teste react"
Enter fullscreen mode Exit fullscreen mode

Instalar habilidade 

ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
Enter fullscreen mode Exit fullscreen mode

Para instalar globalmente:

ctx7 skills install /anthropics/skills pdf --global
Enter fullscreen mode Exit fullscreen mode

Sugestões baseadas no projeto 

ctx7 skills suggest
Enter fullscreen mode Exit fullscreen mode

Detecta libs/frameworks do projeto e sugere habilidades relevantes.

Listar habilidades instaladas 

ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
Enter fullscreen mode Exit fullscreen mode

Remover habilidade 

ctx7 skills remove pdf
Enter fullscreen mode Exit fullscreen mode

Gerar habilidade personalizada com IA

Com conta paga:

ctx7 login
ctx7 skills generate
Enter fullscreen mode Exit fullscreen mode

Siga o prompt para escolher biblioteca e descrever o que a habilidade precisa ensinar. O Context7 gera um SKILL.md alinhado à doc atual.

Limites: Gratuito = 6 gerações/semana, Pro = 10/semana.

Apelidos para comandos

Comando completo Apelido
ctx7 skills install ctx7 si
ctx7 skills search ctx7 ss
ctx7 skills generate ctx7 skills gen ou ctx7 skills g

Usando Context7 nos prompts do assistente de IA

Padrão "use context7"

No modo MCP, adicione ao prompt para garantir documentação atualizada:

Crie um middleware Next.js que verifica um JWT válido nos cookies e redireciona usuários não autenticados para /login. use context7
Enter fullscreen mode Exit fullscreen mode

O agente busca e fundamenta a resposta na doc mais recente.

Referenciar biblioteca específica

Quando usa múltiplas libs:

Implemente autenticação Supabase em um aplicativo Next.js.
use library /supabase/supabase for Supabase and /vercel/next.js for Next.js routing.
Enter fullscreen mode Exit fullscreen mode

Invocação automática sem "use context7"

Adicione esta regra ao seu agente. Exemplo para Claude Code (CLAUDE.md):

Sempre use as ferramentas Context7 MCP ao gerar código que usa bibliotecas de terceiros.
Resolva o ID da biblioteca e busque a documentação atual antes de escrever qualquer implementação.
Faça isso sem esperar que eu peça.
Enter fullscreen mode Exit fullscreen mode

No Cursor, em Configurações > Regras para IA:

Ao escrever código que usa bibliotecas ou frameworks externos, sempre invoque
Context7 para buscar a documentação atual antes de gerar a implementação.
Enter fullscreen mode Exit fullscreen mode

Combine com Apidog para integração de APIs confiável

Context7 mantém o conhecimento atualizado; o Apidog garante que as chamadas API realmente funcionam.

Exemplos práticos:

  • App Next.js + API externa: Context7 alimenta a doc correta, Apidog testa a API real.
  • Nova lib com API HTTP: Context7 entrega doc SDK, Apidog testa endpoints brutos.
  • Depuração: Teste a requisição exata no Apidog para isolar problemas.

No Apidog, configure ambientes (dev/prod) com variáveis de API key, faça asserções automáticas e troque de ambiente facilmente. O combo Context7 + Apidog cobre da doc à execução real.

Preços e limites de uso

A CLI ctx7 é gratuita, com limites por plano:

Plano Preço API calls/mês Limite de taxa Repos privados
Gratuito $0 1.000 60/hora Não
Pro $7/assento/mês 5.000/assento 60/hora/assento Sim ($15/1M tokens para parsear)
Empresarial Personalizado 5.000/assento Personalizado Sim ($25/1M tokens)

Notas do Gratuito:

  • Após o limite, ganha 20 chamadas extras/dia até o mês reiniciar
  • Repos privados: só no Pro ou superior
  • Geração de habilidades: 6/semana (Gratuito), 10/semana (Pro)
  • Pro: até 20 membros

Importante: Context7 depende dos servidores Upstash (não funciona offline). Respostas grandes podem consumir bastante do contexto do LLM em projetos muito complexos.

Obtenha sua chave de API gratuita em context7.com/dashboard para limites maiores.

FAQ

O Context7 envia meu código para seus servidores?

Não. Apenas nome da biblioteca e consulta são enviados. Código, histórico e dados sensíveis ficam fora dos servidores Context7.

Quais bibliotecas são suportadas?

Mais de 9.000 libs/frameworks públicos. Pesquise em context7.com. Envie novas via /add-library na interface.

Quão atualizada é a documentação?

Reindexações frequentes. Lançamentos muito recentes podem demorar alguns dias, mas para libs estáveis a doc segue o último release.

Funciona sem chave de API?

Sim, mas com limites menores. Para uso regular, cadastre-se e configure CONTEXT7_API_KEY.

Quais editores e agentes são suportados?

Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop e qualquer cliente compatível com MCP ou Agent Skills.

Diferença entre CLI + Habilidades e MCP?

  • CLI + Habilidades: agente executa comandos ctx7 conforme instrução do arquivo de habilidade.
  • MCP: agente usa as ferramentas Context7 nativamente, sem prompts explícitos. Mais transparente.

Posso usar ctx7 sem agente de IA?

Sim. ctx7 library e ctx7 docs funcionam como utilitários de terminal independentes.

Recursos adicionais

Top comments (0)