Troubleshooting

Troubleshooting

Common Issues and Solutions

1. Authentication Failures

   • Ensure your Claude.ai credentials are correct
   • Try logging out and logging in again:

     claudesync api logout
     claudesync api login claude.ai
     

2. Sync Errors

   • Check your internet connection
   • Verify file permissions in your local directory
   • Ensure you're not exceeding file size limits

3. Performance Issues

   • Adjust the upload_delay setting
   • Use .claudeignore to exclude unnecessary files

4. WinError 206 When Syncing Large Files

   • This error often occurs when syncing files larger than 32 KB on Windows systems
   • To resolve, try using file input for curl data:

     claudesync config set curl_use_file_input True
     

   • If the issue persists, try reducing the max_file_size in your configuration

Error Messages Explained

• "403 Forbidden": Check your API access and session key
• "File too large": Adjust max_file_size in configuration
• "Connection timeout": Check your network connection
• "WinError 206": See solution above for handling large files on Windows

Logging and Debugging

Enable debug logging:

claudesync config set log_level DEBUG

View logs:

claudesync logs

If you're encountering a WinError or any other persistent issue, it's often helpful to check the debug logs for more detailed error information.

Still Having Issues?

If you're still experiencing problems after trying these solutions:

1. Check our FAQ for more common questions and answers
2. Search or ask in our Discord server
3. Open an issue on our GitHub repository with a detailed description of your problem, including any relevant log outputs

Remember to always ensure you're using the latest version of ClaudeSync, as many issues are resolved in newer releases.