How do I enable verbose output for deep debugging?

You can run Claude Code with the --debug flag or set the environment variable ANTHROPIC_LOG=debug before starting the CLI to see detailed operation logs.

Where can I find the log files for Claude Code?

Log locations vary by OS: ~/Library/Logs/Claude Code/ for macOS, ~/.local/share/claude-code/logs/ for Linux, and %APPDATA%\Claude Code\logs\ for Windows.

What should I do if Claude Code is stuck or hanging?

Press Ctrl+C to stop the current process. If the session remains unresponsive, use the /clear command to wipe the current context or /reset to start a completely fresh session.

How do I run a full system health check in Claude Code?

You can use the 'claude doctor' command in your terminal or the '/doctor' command within a session to perform a comprehensive status check of the API, MCP servers, hooks, and update status.

Claude Code Debugging & Diagnostics

Name: Claude Code Debugging & Diagnostics
Author: hgeldenhuys

byhgeldenhuys

•

開発者ツール

Troubleshoots Claude Code issues using systematic diagnostics, health checks, and recovery procedures to resolve hanging sessions or tool failures.

This skill provides a comprehensive framework for diagnosing and resolving issues within the Claude Code environment. It equips users with a suite of health check commands, debugging flags, and environment variables to identify why tools might be failing, why sessions are hanging, or why MCP servers are disconnected. By integrating systematic decision trees and quick-fix guides, it ensures a stable and high-performing development session, making it essential for developers troubleshooting configuration, permissions, or API-level errors.

主な機能

01System-wide health checks using the claude doctor command and in-session /doctor tool.

02Environment variable mapping for advanced logging, timeout configurations, and proxy settings.

03Standardized log location references for macOS, Linux, and Windows to facilitate deep-dive error analysis.

04Detailed diagnostic decision trees for troubleshooting startup issues, tool failures, and hook errors.

05Quick-reference guides for resolving common issues like context overflow, rate limiting, and permission denials.

061 GitHub stars

ユースケース

01Diagnosing failed tool executions or permission errors during an active coding session.

02Troubleshooting MCP (Model Context Protocol) server connection issues or missing external tools.

03Validating JSON syntax and matcher logic for custom Claude Code hooks and settings.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hgeldenhuys/claude-code-sdk debugging-claude-code

For use in Claude.ai and ChatGPT

Download Skill