Recursos para Desenvolvedores

Claude Code no VS Code e Cursor

Instale a extensão Claude Code no VS Code ou Cursor e conecte suas configurações compartilhadas ao RunAPI.

Visão geral

A extensão oficial do Claude Code funciona tanto no VS Code quanto no Cursor. Ambos os editores utilizam as mesmas configurações de usuário do Claude Code, portanto este guia instala a extensão correspondente e configura o RunAPI uma única vez em ~/.claude/settings.json.

Antes de começar

Instale uma versão compatível do VS Code ou Cursor. A versão mínima atual do VS Code está listada no guia oficial da extensão.
Crie uma Chave de API padrão no Guia de Autenticação. Não a coloque nas configurações do workspace nem no controle de versão.
Copie um identificador de modelo que suporte Anthropic Messages do Catálogo de Modelos.

Instalar

Instale a extensão oficial anthropic.claude-code:

VS Code: abra a listagem do VS Code Marketplace ou pesquise Claude Code em Extensões.
Cursor: abra cursor:extension/anthropic.claude-code ou pesquise Claude Code em Extensões.

A extensão inclui o runtime necessário para seu painel de chat. Instale a CLI autônoma somente se também quiser executar claude no terminal integrado.

Configurar o RunAPI

Abra ~/.claude/settings.json e adicione as configurações de ambiente compartilhadas no nível do usuário:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Nas configurações do VS Code ou Cursor, pesquise por Claude Code login e habilite Disable Login Prompt para esse endpoint personalizado. As configurações do usuário são compartilhadas com a CLI; as configurações da extensão do VS Code controlam apenas o comportamento da extensão.

Mantenha a chave real fora de .claude/settings.json e das configurações de workspace do editor porque esses arquivos podem ser enviados ao repositório.

Escolher um modelo

Substitua YOUR_RUNAPI_MODEL_ID por um identificador exato do Catálogo de Modelos. No painel do Claude Code, /model altera a seleção atual e /status exibe o modelo ativo.

Verificar

Recarregue a janela do editor após alterar a extensão ou as configurações.
Abra o painel Claude Code Spark.
Execute /status e confirme as configurações do usuário e o modelo.
Envie Describe this repository in one sentence. e confirme uma resposta normal.

Solucionar problemas

A extensão não instala: confirme que a versão do editor atende aos requisitos oficiais.
O ícone do Spark está ausente: recarregue a janela do editor e reinicie o editor.
Um prompt de login ainda aparece: habilite Disable Login Prompt nas configurações da extensão Claude Code.
O painel não herda variáveis do shell: use ~/.claude/settings.json ou inicie o editor a partir do terminal configurado. Aplicativos GUI frequentemente iniciam sem o ambiente do terminal.
A CLI funciona, mas o painel não: recarregue a janela e use a CLI autônoma para reproduzir a requisição com diagnósticos mais detalhados.
A autenticação ou a seleção de modelo falha: verifique a chave no Guia de Autenticação e copie o identificador exato do Catálogo de Modelos.

Próximas etapas

Use o Início rápido da LLM API para o comportamento do protocolo e a Referência da API Anthropic Messages para os campos de requisição. Para adicionar ferramentas do RunAPI dentro do editor, continue com a Visão Geral do MCP.