Tutorial de Uso do Claude Code para JetBrains IDE

Claude Code é uma ferramenta de Agentic Coding lançada pela Anthropic, também conhecida como um dos agentes de programação mais poderosos do mundo. Claude Code oferece um plugin específico para JetBrains IDE, suportando IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Android Studio e toda a linha de IDEs da JetBrains. Este documento apresenta como configurar e usar o Claude Code no JetBrains IDE através do serviço de proxy da AceData Cloud.

Processo de Solicitação

Para usar o Claude Code, primeiro você pode acessar a página de serviços Claude Messages e clicar no botão “Acquire” para obter as credenciais necessárias para a solicitação:

Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e logar. Após o login ou registro, você será redirecionado de volta para a página atual. Na primeira solicitação, haverá um crédito gratuito disponível para que você possa experimentar o serviço Claude Code sem custo.

IDEs Suportadas

O plugin Claude Code suporta os seguintes IDEs da JetBrains:

IDE	Linguagens/Cenários
IntelliJ IDEA	Java, Kotlin, Scala, etc.
PyCharm	Python
WebStorm	JavaScript, TypeScript
GoLand	Go
PhpStorm	PHP
Android Studio	Desenvolvimento Android
Outros	A maioria dos IDEs da JetBrains é suportada

Instalação

Pré-requisitos

O plugin Claude Code para JetBrains depende do Claude Code CLI, portanto, certifique-se de que o CLI esteja instalado:

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Ou use o Homebrew
brew install claude-code

Após a instalação, você pode verificar:

claude --version

Instalação do Plugin

Plugin Claude Code no JetBrains Marketplace

Abra o JetBrains IDE
Vá para Settings → Plugins → Marketplace
Pesquise por Claude Code
Clique em Install para instalar o plugin
Reinicie o IDE

Ou acesse diretamente o JetBrains Marketplace para instalação online.

Importante: Após instalar o plugin, é necessário reiniciar completamente o IDE (pode ser necessário reiniciar várias vezes) para que funcione.

Configuração da API AceData Cloud

O plugin Claude Code para JetBrains executa o comando claude através do terminal integrado, portanto, a configuração das variáveis de ambiente é a mesma do CLI.

Passo 1: Criar config.json

Crie o arquivo de configuração do Claude Code:

Sistema	Caminho
macOS / Linux	`~/.claude/config.json`
Windows	`C:\Users\{nome de usuário}\.claude\config.json`

Escreva o seguinte conteúdo neste arquivo e salve:

{
  "primaryApiKey": "self"
}

Comando rápido para criar no macOS / Linux:

mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json

Passo 2: Configurar Variáveis de Ambiente

Método 1: Configurar no arquivo de configuração do Shell (recomendado) Adicione o seguinte conteúdo ao seu ~/.zshrc ou ~/.bashrc, substituindo {token} pelo seu token de API:

# AceData Cloud - Configuração do proxy Claude Code
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"

Após modificar, execute source ~/.zshrc para que a configuração tenha efeito, e então reinicie o JetBrains IDE. Método 2: Configurar no settings.json do Claude Code Edite ~/.claude/settings.json (crie se não existir):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

Dica: O token de API pode ser visualizado no console da AceData Cloud.

Uso Básico

Iniciar a partir do Terminal Integrado do IDE

Abra o terminal integrado do JetBrains IDE e execute:

claude

Ao executar no terminal integrado do IDE, todas as funcionalidades integradas (visualização de Diff, seleção de contexto, etc.) serão ativadas automaticamente.

Conectar a partir do Terminal Externo

Se você estiver executando o Claude Code em um terminal externo, pode usar o comando /ide para se conectar ao JetBrains IDE:

claude
> /ide

Certifique-se de iniciar o Claude Code a partir do mesmo diretório raiz do projeto do IDE, para que o Claude possa acessar o mesmo conjunto de arquivos.

Atalhos

Atalho	Função
`Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux)	Abrir rapidamente o Claude Code
`Cmd+Option+K` (Mac) / `Alt+Ctrl+K` (Windows/Linux)	Inserir referência de arquivo (ex: `@File#L1-99`)

Funcionalidades Integradas

O plugin Claude Code para JetBrains oferece as seguintes funcionalidades integradas:

Visualização de Diff: Mudanças de código são exibidas diretamente no visualizador de Diff do IDE
Seleção de Contexto: O código e a aba selecionados atualmente são compartilhados automaticamente com o Claude
Referência de Arquivo: Use atalhos para referenciar rapidamente arquivos e números de linha
Compartilhamento de Diagnósticos: Informações de diagnóstico como Lint e erros de sintaxe no IDE são compartilhadas automaticamente com o Claude

Configurações do Plugin

Você pode configurar em Settings → Tools → Claude Code [Beta]:

Configuração	Descrição
Comando Claude	Caminho do comando Claude personalizado (ex: `/usr/local/bin/claude`)
Habilitar atualizações automáticas	Verificar e instalar atualizações do plugin automaticamente
Habilitar uso de Option+Enter	Usar Option+Enter no macOS para quebrar linha na caixa de diálogo

Configuração para Usuários WSL

Se você estiver usando em um ambiente WSL, deve definir o comando Claude como:

wsl -d Ubuntu -- bash -lic "claude"

(Substitua Ubuntu pelo nome da sua distribuição WSL)

Perguntas Frequentes

O que fazer se a conexão falhar?

Verifique se o arquivo ~/.claude/config.json foi criado corretamente
Confirme se as variáveis de ambiente estão configuradas corretamente
Verifique se o token de API é válido (pode ser visualizado no console)
Reinicie o JetBrains IDE e tente novamente

O plugin não está funcionando?

Certifique-se de que o Claude Code está sendo executado a partir do diretório raiz do projeto
Verifique se o plugin está habilitado nas configurações do IDE
Reinicie completamente o IDE (pode ser necessário reiniciar várias vezes)
Se estiver usando o modo de desenvolvimento remoto, certifique-se de que o plugin está instalado na máquina remota (Settings → Plugin (Host))

IDE não detectada?

Confirme se o plugin está instalado e habilitado
Reinicie o IDE
Certifique-se de que o Claude Code está sendo executado no terminal integrado
Usuários WSL devem consultar o Guia de Solução de Problemas do WSL

comando não encontrado

Se ao clicar no ícone do Claude aparecer “comando não encontrado”:

Verifique se o CLI está instalado: which claude
Configure o caminho completo do comando Claude nas configurações do plugin
Usuários WSL devem usar o formato de comando WSL mencionado acima

Como verificar o saldo restante?

Faça login no Console da AceData Cloud para visualizar o saldo restante e o uso atual da sua conta.

Saiba mais

📖 Documentação oficial do Claude Code JetBrains
🔧 Serviço Claude Code da AceData Cloud
💬 Se tiver alguma dúvida, sinta-se à vontade para entrar em contato conosco através do suporte da plataforma.

​Processo de Solicitação

​IDEs Suportadas

​Instalação

​Pré-requisitos

​Instalação do Plugin

​Configuração da API AceData Cloud

​Passo 1: Criar config.json

​Passo 2: Configurar Variáveis de Ambiente

​Uso Básico

​Iniciar a partir do Terminal Integrado do IDE

​Conectar a partir do Terminal Externo

​Atalhos

​Funcionalidades Integradas

​Configurações do Plugin

​Configuração para Usuários WSL

​Perguntas Frequentes

​O que fazer se a conexão falhar?

​O plugin não está funcionando?

​IDE não detectada?

​comando não encontrado

​Como verificar o saldo restante?

​Saiba mais