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-officialfails- 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-officialThis 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-officialThis globally configures Git to use HTTPS for all GitHub URLs instead of SSH.
