Troubleshoot Plugins

Troubleshoot plugin installation and configuration problems across IDEs, including network connectivity issues and environment-specific workarounds.

Claude Code Plugin - Installation Issues

Plugin Installation Fails: SSH to GitHub Blocked

Symptoms

  • claude plugin install jfrog@claude-plugins-official fails
  • Error mentions SSH/port 22 or GitHub connection issues
  • Installation hangs or times out when attempting to reach GitHub

Root Cause

Your network blocks SSH (port 22) to GitHub. Claude Code currently has a open issue in which it tries HTTP and not HTTPs. The plugin normally uses SSH by default, but can fall back to HTTPS (port 443) using the solutions below.

Solution 1: Use HTTPS (Recommended)

Requirements: Claude Code v2.1.144 or later. Check your version with claude --version

Set an environment variable before installing:

export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1
claude plugin install jfrog@claude-plugins-official

This forces the plugin download over HTTPS/443 instead of SSH/22.

Solution 2: Configure Git

If environment variables aren't practical in your setup:

git config --global url."https://github.com/".insteadOf [email protected]:
claude plugin install jfrog@claude-plugins-official

This globally configures Git to use HTTPS for all GitHub URLs instead of SSH.