security-guidance plugin fails on Windows: python3 command not found
Resolved 💬 3 comments Opened Jan 3, 2026 by papacrypt Closed Jan 3, 2026
Description
The security-guidance plugin hook fails on Windows with:
PreToolUse:Edit says: Plugin hook error: 'python3' is not recognized as an internal or external command, operable program or batch file.
Environment
- OS: Windows
- Claude Code: latest
- Plugin installed via:
/pluginscommand within Claude Code - Python: 3.14.0 installed and working (
pythoncommand works)
Cause
The hook in plugins/security-guidance/hooks/hooks.json hardcodes python3:
"command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/security_reminder_hook.py"
On Windows, Python is invoked as python, not python3. Even with Python correctly installed and in PATH, python3 doesn't exist:
> where python
C:\Users\...\Python314\python.exe
> where python3
INFO: Could not find files for the given pattern(s).
This is standard Windows behavior - the python3 symlink is a Unix/Linux/macOS convention.
Suggested Fix
Use python instead (works cross-platform when Python 3 is the installed version), or add platform detection.
Workaround
Create a python3.bat file somewhere in your PATH containing:
@"C:\Path\To\Your\python.exe" %*
This aliases python3 to your Python installation.
---
P.S. This issue was drafted with help from Claude, but it seemed confident this was worth raising.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗