Network Debugging - Claude Code Examples

Overview

This CLAUDE.md template is for network troubleshooting, packet analysis, and protocol debugging using tools like tcpdump, tshark, and Wireshark.

What You Can Analyze

Network traffic captures (pcap files)
Connectivity issues
Protocol analysis (HTTP, DNS, TCP, etc.)
Performance troubleshooting
Security investigation

Download CLAUDE.md

Add this file to your network debugging project to guide Claude Code through packet analysis.

Download network-debug.md

Sample Prompts

Try these prompts with Claude Code when using this CLAUDE.md:

Initial Analysis

Analyze this pcap file and give me an overview - what protocols are present, what hosts are communicating, any obvious issues

Specific Protocol

Extract all HTTP requests from this capture and show me the request methods, URLs, and response codes

Troubleshooting

I'm seeing timeouts between 192.168.1.10 and 192.168.1.20. Find the conversation and identify what's failing

Performance Analysis

Analyze TCP performance in this capture - look for retransmissions, slow responses, and connection issues

DNS Issues

Debug DNS resolution in this capture - find queries that failed or took too long to respond

Security Investigation

Review this capture for suspicious activity - unusual ports, scan patterns, or anomalous behavior

Tools & Documentation

Wireshark

Network protocol analyzer with GUI and command-line tools.

Wireshark →

Sample Captures

Practice pcap files for learning packet analysis.

Sample Captures →

tshark Documentation

Command-line packet analyzer documentation.

tshark Docs →

Analysis Tips

                📊 Start with overview - Protocol distribution and statistics first
🎯 Filter for relevance - Focus on specific protocols/hosts
🔍 Correlate events - Track DNS → Connection → Request sequences
🔒 Consider privacy - Sanitize captures before sharing
💡 Perfect for local models - No sensitive data upload needed

            