Troubleshooting

Certainly! Here is the revised documentation in a more conventional format:

Troubleshooting Guide

Common Issues and Solutions

1. Authentication Failures

Ensure Credentials

• Verify your Claude.ai credentials.

Log Out and Log In

claudesync api logout
claudesync api login claude.ai

403 Error

• If you encounter a 403 error, try using the CURL provider:

  claudesync api login claude.ai-curl

  Note for Windows Users: Ensure you have a bash or WSL environment installed to use curl.

2. Sync Errors

Internet Connection

• Check your internet connection.

File Permissions

• Verify permissions in your local directory.

File Size Limits

• Ensure you're not exceeding file size limits.

3. Performance Issues

Upload Delay

• Adjust the upload_delay setting.

Exclude Unnecessary Files

• Use a .claudeignore file to exclude unnecessary files from syncing.

4. WinError 206 When Syncing Large Files

File Size

• This error occurs when syncing files larger than 32 KB on Windows.

Use File Input for Curl Data

claudesync config set curl_use_file_input True

Reduce Max File Size

• Adjust max_file_size in your configuration.

Logging and Debugging

Enable Debug Logging

claudesync config set log_level DEBUG

View Logs

claudesync logs

• Checking the debug logs can provide more detailed error information for persistent issues.

Additional Help

• FAQ: Check our FAQ for more common questions and answers.
• Discord: Join our Discord server for community support.
• GitHub Issues: Open an issue on our GitHub repository with a detailed description of your problem, including any relevant log outputs.

Keep Updated

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