Troubleshooting

ClaudeSync Troubleshooting Guide

1. Authentication Issues

Problem: Unable to authenticate or frequent session timeouts

Troubleshooting steps:

1. Verify Claude.ai credentials
2. Perform a logout and login:

   claudesync api logout
   claudesync api login claude.ai
   

3. If encountering a 403 error, switch to the CURL provider:

   claudesync api login claude.ai-curl
   

   Note: Windows users must ensure bash/WSL is installed.

Problem: cURL error (return code 43)

Solution:

Upgrade cURL to the latest version. For Windows users, refer to the detailed installation guide.

2. Synchronization Errors

Problem: Files fail to sync

Troubleshooting steps:

1. Check internet connection stability
2. Verify local directory permissions
3. Ensure files do not exceed configured size limits

3. Performance Issues

Problem: Slow synchronization

Solutions:

1. Adjust the upload_delay setting:

   claudesync api ratelimit --delay <value_in_seconds>
   

2. Implement a .claudeignore file to exclude unnecessary files

4. Windows-Specific Issues

Problem: WinError 206 when syncing large files

Solutions:

1. Enable file input for cURL:

   claudesync config set curl_use_file_input True
   

2. Adjust maximum file size:

   claudesync api max-filesize --size <value_in_bytes>
   

5. Logging and Debugging

To enable detailed logging:

claudesync config set log_level DEBUG

To view logs:

claudesync logs

Additional Resources

• Frequently Asked Questions
• Discord Support Community
• GitHub Issue Tracker

Always ensure you are using the latest version of ClaudeSync for optimal performance and bug fixes.