Context7 é uma plataforma que injeta documentação de biblioteca atualizada diretamente no contexto do seu assistente de codificação de IA, para que ele pare de gerar código baseado em dados de treinamento desatualizados. A CLI (ctx7) é executada com npx ctx7 (sem instalação necessária) e se conecta ao Claude Code, Cursor ou OpenCode com um único comando ctx7 setup.
O que é Context7 e por que ele é importante?
Aqui está um problema que todo desenvolvedor que usa ferramentas de codificação de IA já encontrou: você pede ao seu assistente para escrever código usando uma biblioteca que você conhece bem, e ele lhe dá algo que parece correto, mas usa APIs que não existem mais. As assinaturas das funções estão erradas. Os caminhos de importação mudaram há duas grandes versões. O exemplo funciona na documentação para a versão 12, mas você está na versão 15.
Isso acontece porque os LLMs são treinados em dados com uma data de corte. Eles não sabem o que mudou no mês passado. Eles não sabem que o Next.js 15 retrabalhou a forma como os layouts funcionam, ou que uma biblioteca da qual você depende depreciou metade de sua superfície de API desde o snapshot de treinamento.
Context7 resolve isso. É uma plataforma construída pela Upstash que indexa a documentação de mais de 9.000 bibliotecas e a serve ao seu assistente de IA em tempo real. Quando você faz uma pergunta ao seu agente de codificação, o Context7 busca a documentação atual, específica da versão, e a coloca na janela de contexto antes que o modelo gere sua resposta.
O resultado: sua ferramenta de codificação de IA para de alucinar APIs e começa a produzir código que corresponde ao que a biblioteca realmente faz hoje.
A CLI ctx7 é a interface de linha de comando para o Context7. Ela faz três coisas:
- Buscar documentação de biblioteca diretamente no seu terminal
- Gerenciar habilidades de codificação de IA (arquivos de prompt reutilizáveis que aprimoram seu agente)
- Configurar o servidor MCP do Context7 para Claude Code, Cursor ou OpenCode
Instalando ctx7
O único requisito é Node.js 18 ou posterior. Verifique sua versão com node --version.
Executar sem instalar
A maneira mais rápida de experimentar o ctx7 é com npx:
npx ctx7 --help
npx ctx7 library react
Isso busca a versão mais recente toda vez que você o executa. Bom para uso ocasional.
Instalar globalmente
Para uso regular, instale globalmente:
npm install -g ctx7
ctx7 --version
Depois disso, cada comando ctx7 é executado localmente sem a sobrecarga do npx.
Configurando Context7 para seu agente de codificação de IA
O comando ctx7 setup conecta o Context7 ao seu ambiente de codificação de IA. Ele autentica via OAuth, gera uma chave de API e escreve a configuração no local correto.
Configuração interativa
ctx7 setup
Isso o solicitará a escolher seu agente e seu modo preferido (CLI + Habilidades vs. MCP). Se você quiser pular os prompts:
ctx7 setup --yes
Apontar para um agente específico
ctx7 setup --claude # Claude Code (~/.claude/skills ou config do MCP)
ctx7 setup --cursor # Cursor (~/.cursor/skills ou config do MCP)
ctx7 setup --opencode # OpenCode
Usar uma chave de API existente
Se você já tem uma chave de API Context7 de context7.com/dashboard:
ctx7 setup --api-key SUA_CHAVE_DE_API
Configuração a nível de projeto vs. global
Por padrão, ctx7 setup instala globalmente. Para configurar apenas para o projeto atual:
ctx7 setup --project
Dois modos: CLI + Habilidades vs. MCP
O modo CLI + Habilidades instala um arquivo SKILL.md que instrui seu agente de IA a buscar documentação executando comandos da CLI ctx7. Seu agente lê as instruções da habilidade e executa autonomamente ctx7 library e ctx7 docs quando precisa de documentação de biblioteca. Nenhum servidor MCP é necessário.
ctx7 setup --cli --claude # Instala habilidade em ~/.claude/skills
ctx7 setup --cli --cursor # Instala habilidade em ~/.cursor/skills
ctx7 setup --cli --universal # Instala em ~/.config/agents/skills
O modo Servidor MCP registra o Context7 como um servidor de Protocolo de Contexto de Modelo. Seu agente chama as ferramentas resolve-library-id e query-docs nativamente sem executar nenhum comando da CLI. A busca de documentação é invisível.
Para o modo MCP, a configuração é assim (adicione às configurações MCP do seu editor):
{
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "SUA_CHAVE_DE_API"
}
}
Ou adicione-o ao Claude Code via CLI:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key SUA_CHAVE_DE_API
Autenticação
ctx7 login # Login OAuth via navegador
ctx7 whoami # Confirmar com qual usuário você está logado
ctx7 logout # Remover credenciais armazenadas
Você também pode definir a chave de API como uma variável de ambiente:
export CONTEXT7_API_KEY=sua_chave_aqui
O login é necessário apenas para geração de habilidades e certos fluxos de configuração. As pesquisas básicas de documentação funcionam sem ele.
Telemetria
O Context7 coleta dados de uso anônimos por padrão. Para desativá-los:
export CTX7_TELEMETRY_DISABLED=1
Buscando documentação da biblioteca a partir do terminal
Mesmo sem um agente de IA envolvido, ctx7 é útil como uma ferramenta autônoma de consulta de documentos. Dois comandos fazem o trabalho pesado.
Resolver um 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 # Saída JSON
Isso pesquisa o índice do Context7 e retorna o ID canônico da biblioteca, junto com metadados: contagem de trechos, reputação da fonte, pontuações de benchmark e identificadores de versão.
Exemplo de saída para ctx7 library nextjs:
Biblioteca: /vercel/next.js
Trechos: 4.820
Reputação: alta
Versão: 15.2.0
Buscar documentação
Uma vez que você tenha um ID de biblioteca, passe-o para ctx7 docs junto com uma consulta de tópico:
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
A saída são trechos de documentação relevantes para sua consulta, extraídos da versão atual da biblioteca. Você pode redirecionar essa saída para um arquivo ou para outra ferramenta.
Se você já conhece o ID da biblioteca, pode pular ctx7 library e ir direto para ctx7 docs.
Gerenciando habilidades de codificação de IA
Habilidades são arquivos SKILL.md que dão ao seu agente de IA conhecimento ou comportamento especializado. Pense neles como pequenos manuais de instruções que seu agente lê antes de abordar um tipo específico de tarefa.
O Context7 hospeda um registro de habilidades contribuídas pela comunidade. Você pode pesquisar nele, instalar habilidades em seu ambiente de agente, gerar habilidades personalizadas e remover o que não precisa.
Pesquisar por habilidades
ctx7 skills search pdf
ctx7 skills search "pagamentos stripe"
ctx7 skills search "teste react"
Instalar uma habilidade
ctx7 skills install /anthropics/skills pdf
ctx7 skills install /anthropics/skills pdf --cursor # Instalar especificamente para Cursor
ctx7 skills install /anthropics/skills pdf --claude # Instalar para Claude Code
Quando você instala globalmente (--global), a habilidade está disponível em todos os seus projetos:
ctx7 skills install /anthropics/skills pdf --global
Obter sugestões com base no seu projeto
ctx7 skills suggest verifica seu diretório de projeto, detecta as bibliotecas e frameworks que você está usando e recomenda habilidades relevantes:
ctx7 skills suggest
Isso funciona bem quando você inicia um novo projeto e quer "semear" seu agente com conhecimento relevante antecipadamente.
Listar habilidades instaladas
ctx7 skills list # Todas as habilidades instaladas
ctx7 skills list --claude # Apenas habilidades instaladas para Claude Code
ctx7 skills list --cursor # Apenas habilidades do Cursor
Remover uma habilidade
ctx7 skills remove pdf
Gerar uma habilidade personalizada com IA
Este é o recurso mais poderoso. Com uma conta paga, você pode gerar uma habilidade personalizada a partir de qualquer biblioteca no índice Context7:
ctx7 login
ctx7 skills generate
A CLI o guiará por um prompt interativo: escolha uma biblioteca, descreva o que você quer que a habilidade ensine ao seu agente, e o Context7 gerará um arquivo SKILL.md adaptado à documentação atual dessa biblioteca.
Habilidades geradas são portáteis. O formato SKILL.md segue o padrão Agent Skills, o que significa que uma habilidade que você gera para o Claude Code funciona inalterada no Cursor, VS Code Copilot, OpenCode e qualquer outra ferramenta compatível com Agent Skills.
Contas gratuitas recebem 6 gerações de habilidades por semana. Contas Pro recebem 10.
Apelidos (aliases) abreviados para digitação mais rápida:
| 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 em seus prompts de IA
Uma vez que o Context7 esteja configurado, você tem algumas maneiras de usá-lo em seu fluxo de trabalho de codificação diário.
O padrão "use context7"
No modo MCP, adicione "use context7" a qualquer prompt onde você deseja 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
Configure um esquema Prisma com modelos de usuário e post e uma relação um-para-muitos. use context7
Como eu configuro o layout do App Router no Next.js 15? use context7
O agente chama automaticamente as ferramentas resolve-library-id e query-docs do Context7, busca a documentação atual e as usa para fundamentar sua resposta.
Referenciar uma biblioteca específica
Se seu prompt envolve várias bibliotecas e você quer que o Context7 se concentre em uma:
Implemente autenticação Supabase em um aplicativo Next.js.
use library /supabase/supabase for Supabase and /vercel/next.js for Next.js routing.
Isso pula a etapa de correspondência de biblioteca e vai direto para a documentação.
Invocação automática sem digitar "use context7"
Adicione uma regra ao seu agente de IA para que ele busque a documentação automaticamente sempre que tocar em código de biblioteca. No Claude Code, adicione ao seu 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.
No Cursor, adicione 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.
Combine com Apidog para total confiança na API
O Context7 mantém o conhecimento da biblioteca do seu assistente de IA atualizado. Mas a documentação precisa é apenas metade da imagem. Ao construir uma integração de API, você também precisa verificar se suas chamadas HTTP reais funcionam como esperado.
Apidog cobre isso. É um cliente de API gratuito onde você pode enviar solicitações, inspecionar respostas, configurar ambientes e automatizar suítes de teste. Ele lida com tudo, desde a exploração ad-hoc de endpoints até testes de integração repetíveis.
Veja como eles se complementam em um fluxo de trabalho real:
Você está construindo um aplicativo Next.js que chama uma API de terceiros. O Context7 fornece ao seu agente de IA a documentação atual do Next.js para que suas sugestões de código sejam corretas. O Apidog permite que você teste a API de terceiros diretamente, verifique a estrutura da resposta e confirme se os payloads que seu código envia correspondem ao que a API espera.
Você está integrando uma nova biblioteca que possui sua própria API HTTP. O Context7 fornece ao seu agente a documentação SDK atual da biblioteca. O Apidog permite que você teste os endpoints de API brutos para entender o comportamento no nível HTTP antes de escrever qualquer código de aplicativo.
Você está depurando uma integração. Você pode enviar a requisição exata que seu código constrói no Apidog, inspecionar a resposta bruta e isolar se o problema está na lógica da sua requisição ou no comportamento da API.
Configure um ambiente no Apidog com suas chaves de API armazenadas como variáveis, alterne entre desenvolvimento e produção com um clique e execute asserções de teste em cada resposta. Context7 + Apidog oferece documentação atual e comportamento de API verificado.
Preços e limites de taxa
A CLI ctx7 é gratuita para usar. Os limites de taxa e o acesso a recursos dependem do seu plano Context7:
| Plano | Preço | Chamadas API/mês | Limite de taxa | Repos privados |
|---|---|---|---|---|
| Gratuito | $0 | 1.000 | 60 requisições/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 sobre o nível gratuito:
- Ao atingir o limite mensal, você ganha 20 chamadas de API bônus por dia até o mês reiniciar
- O acesso a repositórios privados requer o plano Pro ou superior
- Geração de habilidades: 6/semana no Gratuito, 10/semana no Pro
- O Pro suporta um máximo de 20 membros
Limitação importante: Context7 roteia todas as consultas através dos servidores da Upstash. Não há modo offline. Se você estiver em um ambiente sem acesso à internet, a ferramenta não funcionará. As respostas da documentação também podem ser grandes, o que consome a janela de contexto do seu LLM. Em projetos complexos com muitas consultas de biblioteca, isso pode acumular.
Obtenha uma chave de API gratuita em context7.com/dashboard. A chave de API oferece limites de taxa mais altos do que solicitações não autenticadas.
FAQ
O Context7 envia meu código para seus servidores?
Não. Apenas o nome da biblioteca e o texto da consulta são enviados para os servidores do Context7, não o seu código, histórico de conversa ou quaisquer dados sensíveis. Sua base de código permanece com seu provedor de LLM.
Quais bibliotecas o Context7 suporta?
O índice abrange mais de 9.000 bibliotecas e frameworks públicos. Você pode pesquisar no índice em context7.com para verificar se uma biblioteca específica está disponível. Novas bibliotecas podem ser enviadas via /add-library na interface do Context7.
Qual a atualidade da documentação?
As bibliotecas são reindexadas periodicamente. Lançamentos muito recentes (nos últimos dias) podem ainda não estar disponíveis. Para bibliotecas estáveis, a documentação geralmente está atualizada com o último lançamento.
Funciona sem uma chave de API?
O uso básico funciona sem uma chave de API, mas com limites de taxa mais baixos. Para uso regular, registre-se em context7.com e defina CONTEXT7_API_KEY para obter maior rendimento.
Quais editores e agentes ele suporta?
Context7 funciona com Claude Code, Cursor, OpenCode, VS Code Copilot, Windsurf, Claude Desktop e qualquer outro cliente que suporte MCP ou o padrão Agent Skills.
Qual a diferença entre o modo CLI + Habilidades e o modo MCP?
No modo CLI + Habilidades, um arquivo de habilidade instrui seu agente a executar comandos ctx7 explicitamente quando precisa de documentação. No modo MCP, seu agente chama as ferramentas do Context7 nativamente através do protocolo MCP. O modo MCP é mais transparente para o usuário e não exige nenhum prompt explícito "use context7" uma vez configurado.
Posso usar ctx7 sem um agente de codificação de IA?
Sim. ctx7 library e ctx7 docs funcionam como comandos de terminal autônomos. Você pode consultar a documentação da biblioteca diretamente sem nenhum agente de IA envolvido.