[BUG] PowerLevel10k terminal theme causes Claude Code timeout and parsing failures due to ANSI escape sequence contamination

Environment

• Platform (select one):
• [x] Anthropic API
• [ ] AWS Bedrock
• [ ] Google Vertex AI
• [ ] Other: <!-- specify -->
• Claude CLI version: 1.0.71 (Claude Code)
• Operating System: macOS tahoe beta & macOS 15.5
• Terminal: default mac terminal, iterm2

Bug Description
Claude Code experiences systematic timeout failures and parsing errors when used in environments with PowerLevel10k (p10k) Zsh theme installed. The issue manifests as API request timeouts, malformed requests due to ANSI escape sequence contamination, and "Shell Integration Unavailable" errors. This affects all Claude Code operations and renders the tool unusable without disabling PowerLevel10k features.
Note: PowerLevel10k currently has limited support status with the project maintainer stating "THE PROJECT HAS VERY LIMITED SUPPORT" as of 2025, but remains widely deployed in existing development environments.
Steps to Reproduce

Install PowerLevel10k Zsh theme with default configuration (instant prompt enabled)
Open terminal with Zsh + PowerLevel10k active
Navigate to any project directory
Run any Claude Code command (e.g., claude "help me debug this code")
Observe timeout errors and failed API communication

Alternative reproduction:

Install PowerLevel10k with: git clone --depth=1 https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k
Set ZSH_THEME="powerlevel10k/powerlevel10k" in .zshrc
Ensure instant prompt is enabled (default behavior)
Restart terminal and attempt Claude Code operations

Expected Behavior
Claude Code should function normally regardless of terminal theme choice, successfully:

Authenticating with Anthropic API
Parsing terminal output for context
Executing commands and receiving responses
Maintaining shell integration in VSCode terminals

Actual Behavior

Timeout Errors: API requests consistently timeout during communication
Parsing Failures: Terminal output parsing fails due to ANSI escape sequence contamination
Shell Integration Failures: VSCode terminals show "Shell Integration Unavailable" errors
Malformed Requests: API requests contain corrupted data with escape sequences like \x1B[31m or \x1B]633;C\x07
Hanging Operations: Commands appear to execute but Claude Code hangs indefinitely waiting for clean output

Additional Context
Scope of Issue

Affected Users: Anyone using PowerLevel10k (50K+ GitHub stars, though project has limited support as of 2025)
System-wide Impact: Affects all terminals, not limited to VSCode integration
Reproducibility: 100% consistent across different systems and configurations

Technical Root Cause
PowerLevel10k's instant prompt feature redirects stdin/stdout during shell initialization and injects ANSI escape sequences into terminal output streams. This conflicts with VSCode's Terminal Shell Integration API (introduced in VSCode 1.93, August 2024) that modern AI coding tools rely on for terminal communication.
Ecosystem Evidence
This same issue affects other AI CLI tools across the development ecosystem:

Cursor AI: Commands hang with "Running terminal command..."
Cline Project: Officially recommends removing PowerLevel10k in troubleshooting guides
Claude Coder (Kodu AI): Lists PowerLevel10k as "common culprit" for terminal issues
VS Code Copilot Agent: Similar terminal hanging issues documented

Proven Solutions Available
The JavaScript/Node.js ecosystem has established solutions for this exact problem:

strip-ansi package (9,577 dependent packages) - industry standard for ANSI code removal
Node.js built-in util.stripVTControlCharacters() (available since v16.11.0) - zero-dependency solution
chalk package (127,433 dependent packages) - demonstrates terminal capability detection patterns

Workarounds (Temporary)

Disable instant prompt: typeset -g POWERLEVEL9K_INSTANT_PROMPT=off
Switch to simpler terminal themes or Starship (modern alternative)
Use environment-specific configurations that detect AI tools

Attached Technical Analysis
A comprehensive technical report (attached as .md file) details the root cause, provides ecosystem evidence, and outlines specific implementation solutions based on proven approaches from the JavaScript CLI ecosystem.
Request: Implement automatic ANSI escape sequence stripping for terminal output parsing, similar to how other Node.js CLI tools handle this compatibility challenge. This would resolve the issue without requiring users to modify their preferred terminal configurations or abandon widely-deployed development environments.

cor_anthropic_powerlevel10k_bug_report.md