skills.rest
reggiechan74
reggiechan74COMMUNITY
Explore all skills by this author →
WebsiteGitHub

troubleshooting

Diagnose Claude Code installation, authentication, and IDE integration issues via CLI instructions and environment checks.

5|1|Updated Oct 30, 2025
Search Tags:#performance#debugging#authentication#troubleshooting#support#installation#errors#ide integration
One-click install
npx skills add https://github.com/reggiechan74/claude-plugins --skill troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/reggiechan74/claude-plugins/tree/main/plugins/claude-code-metaskill/skills/troubleshooting
Command: npx skills add https://github.com/reggiechan74/claude-plugins --skill troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users often encounter installation, authentication, performance, or integration issues that can halt their workflow. This Skill provides a comprehensive guide to diagnosing and resolving common problems, getting you back to coding faster.

Core Features & Use Cases

  • Installation Fixes: Solutions for Windows WSL, Linux/Mac permission errors, and native installer issues.
  • Authentication & Permissions: Steps to reset authentication, manage tool permissions, and resolve "Permission denied" errors.
  • Performance Optimization: Tips to reduce context size, cancel unresponsive operations, and fix search functionality by installing ripgrep.
  • Use Case: If Claude Code is running slowly, use this skill to learn about /compact to reduce context size or how to install ripgrep for faster search, instantly improving your experience.

Quick Start

My Claude Code installation is failing on Windows WSL. What should I do?

Frequently Asked Questions about troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Claude Code installation errors on Windows WSL?▼

Installation failures on Windows WSL typically stem from permission or path issues. Run environment checks via CLI, verify WSL2 is active, confirm file permissions in the installation directory, and use the native installer with elevated privileges. Consult step-by-step CLI instructions in the troubleshooting guide for your specific error.

Why is Claude Code running slowly and how do I optimize performance?▼

Slow performance usually results from large context size or missing search dependencies. Use the `/compact` command to reduce context, install `ripgrep` to accelerate search functionality, and cancel unresponsive operations. These steps restore responsiveness without reinstallation.

How do I resolve authentication and permission errors in Claude Code?▼

Authentication and permission failures require credential reset and tool permission verification. Follow steps to reset authentication tokens, check file and directory permissions across Windows WSL, Linux, and macOS, and apply mitigation actions for "Permission denied" errors specific to your environment.

How do I troubleshoot IDE integration issues with Claude Code?▼

IDE integration problems in JetBrains environments stem from plugin configuration or environment mismatches. Verify plugin installation, check IDE-to-CLI communication paths, confirm environment variables are set correctly, and apply environment-specific diagnostics provided in the troubleshooting steps.

What should I check if Claude Code won't authenticate?▼

Authentication failures require credential verification and permission checks. Reset authentication credentials via CLI, verify token storage permissions, confirm network connectivity, and check for conflicting tool permissions. Follow the step-by-step authentication reset procedure for your platform.

Can I use Claude Code on Linux and macOS with the same troubleshooting steps?▼

Yes. Troubleshooting covers installation, authentication, performance, and integration across Windows WSL, Linux, and macOS. Platform-specific permission and path issues are addressed with CLI instructions tailored to each environment.

Related Skills

Explore More Software Engineering Skills→
brabos-aibrabos-ai
8

add-dev-environment-setup

Diagnose and install WSL, bash, git, jq, and gh CLI across operating systems.

Official
Advanced
TimHL5TimHL5

canary

Monitor post-deploy web apps for console errors, performance metrics, and page failures.

Community
Advanced
gztcodegztcode

xitter

Interact with Twitter via the x-cli terminal client.

Community
Intermediate
mathruffian-dotmathruffian-dot
70

codex-env-setup

Set up Codex environments across desktop, CLI, and IDE extensions.

Community
Intermediate