# Claudia Windows Fix v4.2

This folder contains the Windows compatibility fix for Claudia GUI.

## Files

1. **1-claudia-windows-fix.md** - Complete installation guide (READ THIS FIRST!)
2. **2-claude_binary_patch.rs** - Version compatibility patch for main.rs
3. **3-setup-windows.bat** - Automated setup script for WSL bridge
4. **4-start-claudia.bat** - Pre-flight check and launcher script
5. **5-apply-patches.bat** - Automatic Windows patch applicator (NEW!)
6. **patches/** folder - (Optional) Contains pre-patched files if automatic patching fails

## Installation Order

⚠️ **IMPORTANT:** Follow the files in numerical order!

1. Read the complete guide in `1-claudia-windows-fix.md`
2. Apply the patch from `2-claude_binary_patch.rs` to your main.rs
3. Run `3-setup-windows.bat` to set up the WSL bridge
4. Run `5-apply-patches.bat` to automatically patch build scripts
5. Use `4-start-claudia.bat` to launch Claudia

**Note:** Step 4 uses file #5 because it patches the build scripts after setup.

## Why This Order?

The patch (file #2) is applied first because:
- It's a simple code change with no external dependencies
- It prepares Claudia to accept different Claude CLI versions
- The setup script (file #3) can then install any Claude version
- This prevents version mismatch errors during setup

## What's New in v4.2

- Fixed installation order documentation
- Added comprehensive build script patches
- Improved icon error handling
- Clear build environment requirements (Windows CMD vs WSL)
- Better error messages and solutions
- Automatic patch script for easier installation
- Pre-patched files as backup option

## Troubleshooting Patches

If `5-apply-patches.bat` fails, you can use the pre-patched files:

```cmd
# From Claudia root directory:
copy .gist_v4.2\patches\fetch-and-build.js scripts\
copy .gist_v4.2\patches\build-executables.js scripts\
copy .gist_v4.2\patches\tauri.conf.json src-tauri\
```

## Quick Tips

- Always build in Windows CMD/PowerShell, NOT in WSL
- Check that all steps have been installed correctly before proceeding
- If you encounter icon errors, check the troubleshooting section
- Claude Code must be installed in WSL, not Windows
- The numbered files should be executed in order (2→3→4→5)
- The start script must be copied to the main Claudia folder

For detailed instructions, see `1-claudia-windows-fix.md`