Passo 1: Pré-requisitos

Antes de começar

1. PyCharm 2024.3 ou superior instalado (Community ou Professional)
2. Node.js 18+ instalado (exigido pelo Claude Code)
3. Claude Code CLI instalado:

npm install -g @anthropic-ai/claude-code

4. Chave da bsf.ai em mãos → Obter chave

Passo 2: Instalar o plugin do Claude Code

Instalação pelo JetBrains Marketplace

1. Abra o PyCharm e vá em Settings (Mac: Cmd+, / Windows: Ctrl+Alt+S)
2. Selecione Plugins → clique na aba Marketplace
3. Pesquise por "Claude Code"
4. Encontre o plugin oficial publicado pela Anthropic e clique em Install
5. Clique em Restart IDE para reiniciar o PyCharm

NOTE

O plugin embute um terminal dentro do PyCharm para executar o Claude Code CLI, então o CLI precisa estar instalado antes.

Passo 3: Configurar o gateway da bsf.ai

Opção 1: arquivo de configuração do Claude Code (recomendado)

Edite ~/.claude/settings.json (Windows: C:\Users\YourUsername\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_bsf_ai_key",
    "ANTHROPIC_BASE_URL": "https://api.bsf.ai",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

Opção 2: variáveis de ambiente do sistema

macOS / Linux:

echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.bsf.ai", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your_api_key", "User")

Reinicie o PyCharm depois de definir as variáveis de ambiente.

Passo 4: Comece a usar

Abra o painel do Claude Code

1. Depois de reiniciar o PyCharm, você verá uma aba "Claude Code" na barra de ferramentas inferior
2. Clique nela para abrir o painel de terminal do Claude Code
3. Ele executa automaticamente o comando claude e conecta à bsf.ai

Operações comuns

• Conversar: digite suas perguntas ou pedidos direto no painel
• Referenciar arquivos: use @filename para referenciar arquivos do projeto
• Limpar o contexto: digite /clear para começar uma conversa nova e economizar tokens
• Obter ajuda: digite /help para ver todos os comandos disponíveis

Perguntas frequentes

Problema: a aba Claude Code não aparece

1. Confirme que o plugin está instalado e ativado: Settings → Plugins → Installed → pesquise por Claude Code
2. Tente abrir pelo menu: View → Tool Windows → Claude Code
3. Verifique se a sua versão do PyCharm é >= 2024.3

Problema: comando claude não encontrado

Confirme que o Claude Code CLI está instalado globalmente e disponível no seu PATH:

which claude    # macOS/Linux
where claude    # Windows

Se não encontrar, reinstale:

npm install -g @anthropic-ai/claude-code

Problema: timeout ou erros de conexão

1. Verifique se as variáveis de ambiente estão definidas corretamente (reinicie o PyCharm após alterá-las)
2. Teste no terminal do PyCharm:

echo $ANTHROPIC_BASE_URL
# Should output https://api.bsf.ai

3. Verifique se a sua chave de API é válida → Console