Troubleshooting

Troubleshooting Guide

Common Issues and Solutions

1. Authentication Failures

• Verify Claude.ai credentials
• Logout/login:

  claudesync api logout
  claudesync api login claude.ai
  

• For 403 error, use CURL provider:

  claudesync api login claude.ai-curl
  

  (Windows users: Ensure bash/WSL is installed)

2. Sync Errors

• Check internet connection
• Verify local directory permissions
• Ensure files don't exceed size limits

3. Performance Issues

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

4. WinError 206 (Large Files on Windows)

• Set curl_use_file_input True
• Adjust max_file_size in configuration

Logging and Debugging

• Enable debug logging:

  claudesync config set log_level DEBUG
  

• View logs:

  claudesync logs
  

Additional Help

• Check FAQ
• Join Discord
• Open GitHub issue

Always use the latest ClaudeSync version for best results.