[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-jahwag--ClaudeSync":3,"tool-jahwag--ClaudeSync":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",144730,2,"2026-04-07T23:26:32",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":79,"languages":80,"stars":85,"forks":86,"last_commit_at":87,"license":88,"difficulty_score":32,"env_os":89,"env_gpu":90,"env_ram":90,"env_deps":91,"category_tags":95,"github_topics":96,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":101,"updated_at":102,"faqs":103,"releases":131},5361,"jahwag\u002FClaudeSync","ClaudeSync","ClaudeSync is a Python tool that automates the synchronization of local files with Claude.ai Projects","ClaudeSync 是一款专为提升 AI 协作效率而设计的 Python 工具，它能自动将您本地开发环境中的文件与 Claude.ai 的项目进行双向同步。对于习惯在本地代码编辑器中工作，同时又希望利用 Claude.ai 强大上下文理解能力的用户来说，它完美解决了手动复制粘贴代码片段繁琐且易出错的痛点，让本地文件管理与云端 AI 对话无缝衔接。\n\n这款工具特别适合软件开发者、技术研究人员以及需要频繁处理代码库的工程师使用。通过简单的命令行操作，用户即可轻松实现文件的上传与更新，将其自然地融入现有的自动化工作流中。ClaudeSync 支持 Windows、macOS 和 Linux 全平台，提供丰富的配置选项以满足不同场景需求，并采用 SSH 密钥机制保障凭证存储的安全性。\n\n值得注意的是，ClaudeSync 目前仅支持 Claude.ai 的 Pro 和 Team 付费计划。作为一个独立的开源项目，它虽非 Anthropic 官方出品，但凭借轻量级、高兼容性和对数据隐私的重视，已成为许多开发者优化 AI 辅助编程流程的得力助手。只需几条指令，您就能让本地代码实时“同步”到 AI","ClaudeSync 是一款专为提升 AI 协作效率而设计的 Python 工具，它能自动将您本地开发环境中的文件与 Claude.ai 的项目进行双向同步。对于习惯在本地代码编辑器中工作，同时又希望利用 Claude.ai 强大上下文理解能力的用户来说，它完美解决了手动复制粘贴代码片段繁琐且易出错的痛点，让本地文件管理与云端 AI 对话无缝衔接。\n\n这款工具特别适合软件开发者、技术研究人员以及需要频繁处理代码库的工程师使用。通过简单的命令行操作，用户即可轻松实现文件的上传与更新，将其自然地融入现有的自动化工作流中。ClaudeSync 支持 Windows、macOS 和 Linux 全平台，提供丰富的配置选项以满足不同场景需求，并采用 SSH 密钥机制保障凭证存储的安全性。\n\n值得注意的是，ClaudeSync 目前仅支持 Claude.ai 的 Pro 和 Team 付费计划。作为一个独立的开源项目，它虽非 Anthropic 官方出品，但凭借轻量级、高兼容性和对数据隐私的重视，已成为许多开发者优化 AI 辅助编程流程的得力助手。只需几条指令，您就能让本地代码实时“同步”到 AI 项目中，享受更流畅的智能开发体验。","# ClaudeSync\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![PyPI](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fclaudesync.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fclaudesync\u002F)\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease\u002Fjahwag\u002Fclaudesync.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Freleases)\n[![Build Status](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Factions\u002Fworkflows\u002Fpython-package.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Factions\u002Fworkflows\u002Fpython-package.yml)\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fjahwag\u002Fclaudesync)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues)\n[![Code Style: Black](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode%20style-black-000000.svg)](https:\u002F\u002Fgithub.com\u002Fpsf\u002Fblack)\n[![Dependencies](https:\u002F\u002Fimg.shields.io\u002Flibrariesio\u002Fgithub\u002Fjahwag\u002Fclaudesync)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fnetwork\u002Fdependencies)\n[![Last Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fjahwag\u002Fclaudesync.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fcommits\u002Fmain)\n[![Sponsor jahwag](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-♥-red)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)\n\n\nClaudeSync bridges your local development environment with Claude.ai projects, enabling seamless synchronization to enhance your AI-powered workflow.\n\n![ClaudeSync in Action](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjahwag_ClaudeSync_readme_10a109c49136.gif)\n\n## ⚠️ Disclaimer\n\nClaudeSync is an independent, open-source project **not affiliated** with Anthropic or Claude.ai. By using ClaudeSync, you agree to:\n\n1. Use it at your own risk.\n2. Acknowledge potential violation of Anthropic's Terms of Service.\n3. Assume responsibility for any consequences.\n4. Understand that Anthropic does not support this tool.\n\nPlease review [Anthropic's Terms of Service](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fconsumer-terms) before using ClaudeSync.\n\n## 🌟 Features\n\n- **File sync**: Synchronize local files with [Claude.ai projects](https:\u002F\u002Fwww.anthropic.com\u002Fnews\u002Fprojects).\n- **Cross-Platform**: Compatible with [Windows, macOS, and Linux](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Freleases).\n- **Configurable**: Plenty of [configuration options](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fwiki\u002FQuick-reference).\n- **Integrate**: Designed to be easy to integrate into your pipelines.\n- **Secure**: Ensures data privacy and security.\n\n## ⚙️ Prerequisites\n\n### 📄 Supported Claude.ai plans\n\n| [Plan](https:\u002F\u002Fwww.anthropic.com\u002Fpricing)   | Supported |\n|--------|-----------|\n| Pro    | ✅        |\n| Team   | ✅        |\n| Free   | ❌        |\n\n### 🔑 SSH Key\n\nEnsure you have an SSH key for secure credential storage. Follow [GitHub's guide](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fauthentication\u002Fconnecting-to-github-with-ssh) to generate and add your SSH key.\n\n### 💻 Software\n\n- **Python**: ≥ [3.10](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n- **pip**: [Python package installer](https:\u002F\u002Fpip.pypa.io\u002Fen\u002Fstable\u002Finstallation\u002F)\n\n## 🚀 Quick Start\n\n1. **Install ClaudeSync**\n    ```shell\n    pip install claudesync\n    ```\n\n2. **Authenticate**\n    ```shell\n    claudesync auth login\n    ```\n\n3. **Create a Project**\n    ```shell\n    claudesync project create\n    ```\n\n4. **Start Syncing***\n    ```shell\n    claudesync push\n    ```\n    **This is a one-way sync. Files not present locally will be removed from the Claude.ai project unless pruning is [disabled](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fwiki\u002FQuick-reference#pruning-remote).*\n\n📚 [Detailed Guides & FAQs](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fwiki)\n\n## 🤝 Support & Contribute\n\nEnjoying ClaudeSync? Support us by:\n\n- ⭐ [Starring the Repository](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync)\n- 🐛 [Reporting Issues](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues)\n- 🌍 [Contributing](CONTRIBUTING.md)\n- 💬 [Join Our Discord](https:\u002F\u002Fdiscord.gg\u002FpR4qeMH4u4)\n- 💖 [Sponsor Us](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)\n\nYour contributions help improve ClaudeSync!\n\n---\n\n[Contributors](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fgraphs\u002Fcontributors) • [License](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fblob\u002Fmaster\u002FLICENSE) • [Report Bug](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues) • [Request Feature](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues\u002Fnew?labels=enhancement&template=feature_request.md)• [Sponsor](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)\n","# ClaudeSync\n\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![PyPI](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fclaudesync.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fclaudesync\u002F)\n[![发布版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease\u002Fjahwag\u002Fclaudesync.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Freleases)\n[![构建状态](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Factions\u002Fworkflows\u002Fpython-package.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Factions\u002Fworkflows\u002Fpython-package.yml)\n[![问题数](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fjahwag\u002Fclaudesync)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues)\n[![代码风格：Black](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode%20style-black-000000.svg)](https:\u002F\u002Fgithub.com\u002Fpsf\u002Fblack)\n[![依赖关系](https:\u002F\u002Fimg.shields.io\u002Flibrariesio\u002Fgithub\u002Fjahwag\u002Fclaudesync)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fnetwork\u002Fdependencies)\n[![最近提交](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fjahwag\u002Fclaudesync.svg)](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fcommits\u002Fmain)\n[![赞助jahwag](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-♥-red)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)\n\n\nClaudeSync 将您的本地开发环境与 Claude.ai 项目连接起来，实现无缝同步，从而提升您的 AI 驱动工作流效率。\n\n![ClaudeSync 运行示例](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjahwag_ClaudeSync_readme_10a109c49136.gif)\n\n## ⚠️ 免责声明\n\nClaudeSync 是一个独立的开源项目，**与 Anthropic 或 Claude.ai 无任何关联**。使用 ClaudeSync 即表示您同意：\n\n1. 自行承担使用风险。\n2. 承认可能违反 Anthropic 的服务条款。\n3. 对任何后果自行负责。\n4. 知晓 Anthropic 不支持此工具。\n\n请在使用 ClaudeSync 之前仔细阅读 [Anthropic 的服务条款](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fconsumer-terms)。\n\n## 🌟 功能特性\n\n- **文件同步**：将本地文件与 [Claude.ai 项目](https:\u002F\u002Fwww.anthropic.com\u002Fnews\u002Fprojects) 同步。\n- **跨平台**：兼容 [Windows、macOS 和 Linux](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Freleases)。\n- **可配置**：提供丰富的 [配置选项](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fwiki\u002FQuick-reference)。\n- **集成便捷**：易于集成到您的工作流中。\n- **安全可靠**：确保数据隐私与安全。\n\n## ⚙️ 前置条件\n\n### 📄 支持的 Claude.ai 方案\n\n| [方案](https:\u002F\u002Fwww.anthropic.com\u002Fpricing)   | 支持 |\n|--------|-----------|\n| Pro    | ✅        |\n| Team   | ✅        |\n| Free   | ❌        |\n\n### 🔑 SSH 密钥\n\n请确保您已生成并存储 SSH 密钥，以安全地保存凭据。您可以按照 [GitHub 的指南](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fauthentication\u002Fconnecting-to-github-with-ssh) 来生成和添加 SSH 密钥。\n\n### 💻 软件要求\n\n- **Python**：≥ [3.10](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n- **pip**：[Python 包管理器](https:\u002F\u002Fpip.pypa.io\u002Fen\u002Fstable\u002Finstallation\u002F)\n\n## 🚀 快速入门\n\n1. **安装 ClaudeSync**\n    ```shell\n    pip install claudesync\n    ```\n\n2. **认证登录**\n    ```shell\n    claudesync auth login\n    ```\n\n3. **创建项目**\n    ```shell\n    claudesync project create\n    ```\n\n4. **开始同步***\n    ```shell\n    claudesync push\n    ```\n    **这是一次性单向同步。如果本地不存在某些文件，它们将从 Claude.ai 项目中移除，除非禁用修剪功能（详见 [快速参考](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fwiki\u002FQuick-reference#pruning-remote)）。*\n\n📚 [详细指南与常见问题解答](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fwiki)\n\n## 🤝 支持与贡献\n\n喜欢 ClaudeSync 吗？请通过以下方式支持我们：\n\n- ⭐ [星标本仓库](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync)\n- 🐛 [报告问题](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues)\n- 🌍 [参与贡献](CONTRIBUTING.md)\n- 💬 [加入我们的 Discord](https:\u002F\u002Fdiscord.gg\u002FpR4qeMH4u4)\n- 💖 [赞助我们](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)\n\n您的支持将帮助我们不断改进 ClaudeSync！\n\n---\n\n[贡献者](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fgraphs\u002Fcontributors) • [许可证](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fblob\u002Fmaster\u002FLICENSE) • [报告错误](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues) • [请求功能](https:\u002F\u002Fgithub.com\u002Fjahwag\u002Fclaudesync\u002Fissues\u002Fnew?labels=enhancement&template=feature_request.md) • [赞助](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjahwag)","# ClaudeSync 快速上手指南\n\nClaudeSync 是一款开源工具，旨在打通本地开发环境与 Claude.ai 项目，实现文件的无缝同步，从而提升 AI 辅助开发的工作流效率。\n\n> **⚠️ 重要提示**：本项目为独立开源项目，**非** Anthropic 或 Claude.ai 官方出品。使用前请知悉：\n> 1. 使用风险自负。\n> 2. 可能违反 Anthropic 的服务条款。\n> 3. 需自行承担所有后果。\n> 4. Anthropic 不提供对此工具的支持。\n>\n> 请务必在使用前阅读 [Anthropic 服务条款](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fconsumer-terms)。\n\n## 环境准备\n\n在开始之前，请确保满足以下系统和软件要求：\n\n### 1. 系统要求\n*   **操作系统**：Windows、macOS 或 Linux。\n*   **Claude.ai 订阅计划**：仅支持 **Pro** 和 **Team** 计划（❌ 不支持 Free 免费计划）。\n\n### 2. 前置依赖\n*   **Python**：版本需 ≥ 3.10。\n*   **pip**：Python 包安装器。\n*   **SSH 密钥**：用于安全存储凭证。\n    *   若尚未生成，请参考 [GitHub 官方指南](https:\u002F\u002Fdocs.github.com\u002Fen\u002Fauthentication\u002Fconnecting-to-github-with-ssh) 生成并添加 SSH Key。\n\n## 安装步骤\n\n使用 pip 即可快速安装 ClaudeSync。国内用户如遇下载缓慢，可指定清华或阿里镜像源加速安装。\n\n**标准安装：**\n```shell\npip install claudesync\n```\n\n**国内加速安装（推荐）：**\n```shell\npip install claudesync -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n## 基本使用\n\n安装完成后，按以下四个步骤即可完成从认证到同步的流程：\n\n**1. 登录认证**\n运行以下命令并按照提示完成身份验证：\n```shell\nclaudesync auth login\n```\n\n**2. 创建项目关联**\n将本地目录与 Claude.ai 上的项目进行绑定：\n```shell\nclaudesync project create\n```\n\n**3. 开始同步**\n执行推送命令，将本地文件同步至云端：\n```shell\nclaudesync push\n```\n\n> **注意**：此为**单向同步**。默认情况下，本地不存在的文件将从 Claude.ai 项目中被删除（除非在配置中禁用修剪功能 `pruning`）。\n\n---\n*更多详细配置与高级用法，请参阅官方 Wiki 文档。*","某全栈开发者正在本地 VS Code 中重构一个大型 Python 项目，并需要频繁利用 Claude.ai Projects 的长上下文能力进行代码审查和架构优化。\n\n### 没有 ClaudeSync 时\n- **手动上传繁琐**：每次修改代码后，必须手动打开浏览器，逐个拖拽文件到 Claude.ai 网页端，耗时且容易遗漏更新。\n- **版本混乱风险**：本地与云端文件不同步，导致 AI 基于旧代码生成建议，开发者需反复核对差异，极易引入逻辑错误。\n- **上下文断裂**：无法一键同步整个项目结构，只能片段式提问，限制了 AI 对整体架构的理解深度。\n- **工作流割裂**：需要在终端写代码和浏览器聊天之间频繁切换，严重打断编程心流，降低开发效率。\n\n### 使用 ClaudeSync 后\n- **自动化同步**：只需在终端运行 `claudesync push`，即可将本地所有变更秒级同步至 Claude.ai Projects，无需任何手动拖拽。\n- **实时一致性**：确保云端项目始终与本地最新代码完全一致，AI 生成的每一行建议都基于当前真实状态，消除幻觉风险。\n- **完整上下文继承**：一键同步整个目录树，让 Claude 能够理解项目全貌，从而提供更具全局观的重构方案和 Bug 修复建议。\n- **无缝流水线集成**：可将同步命令嵌入 CI\u002FCD 脚本或本地保存钩子，实现“保存即同步”，让开发者专注于代码本身而非文件传输。\n\nClaudeSync 通过打通本地环境与云端智能的壁垒，将原本割裂的文件管理转变为自动化的流畅体验，极大释放了 AI 辅助编程的潜力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fjahwag_ClaudeSync_2f9e9724.png","jahwag","Jahziah Wagner","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fjahwag_47fb8529.png",null,"@Bytelope ","Stockholm","https:\u002F\u002Fgithub.com\u002Fjahwag",[81],{"name":82,"color":83,"percentage":84},"Python","#3572A5",100,704,69,"2026-04-07T00:12:49","MIT","Windows, macOS, Linux","未说明",{"notes":92,"python":93,"dependencies":94},"需要有效的 Claude.ai Pro 或 Team 订阅（不支持免费版）；需配置 SSH 密钥用于安全存储凭证；该工具为单向同步，本地不存在的文件将从云端项目中删除（除非禁用修剪功能）；使用前请知悉可能违反 Anthropic 服务条款的风险。","3.10+",[],[14,35],[97,98,99,100],"claude-ai","llm","python","productivity-tool","2026-03-27T02:49:30.150509","2026-04-08T13:02:30.692955",[104,109,114,118,122,127],{"id":105,"question_zh":106,"answer_zh":107,"source_url":108},24312,"执行组织列表或选择命令时遇到 403 Forbidden 错误怎么办？","这通常意味着会话密钥（sessionKey）无效或权限不足。请尝试以下步骤：\n1. 退出并重新登录：运行 `claudesync api logout` 然后 `claudesync api login claude.ai`。\n2. 如果问题依旧，尝试使用 curl 提供者作为变通方案：\n   - 运行 `claudesync api logout`\n   - 运行 `claudesync api login claude.ai-curl`\n   - 输入您的 sessionKey\n3. 确保您在浏览器中访问 https:\u002F\u002Fclaude.ai\u002Fapi\u002Forganizations 能正常返回数据，以确认账户权限正常。\n4. 检查您的 Claude.ai 订阅计划是否支持 API 访问。","https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fissues\u002F9",{"id":110,"question_zh":111,"answer_zh":112,"source_url":113},24313,"提示\"Error: No active provider set\"错误如何解决？","此错误表示尚未为当前项目设置目标组织和项目。请按顺序执行以下命令进行配置：\n1. 设置组织：`claudesync organization set`\n2. 设置项目：`claudesync project set`\n或者，您可以直接使用 `claudesync project create` 创建新项目，该命令会自动配置组织和项目信息。\n执行成功后，当前目录下会生成一个隐藏的 `.claudesync` 目录，其中包含配置信息。注意：有时可能需要重复执行一次设置命令才能生效。","https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fissues\u002F74",{"id":115,"question_zh":116,"answer_zh":117,"source_url":113},24314,"如何在大型项目中减少上下文窗口大小？","可以通过定义子模块（submodules）来减少上下文窗口大小。虽然文档未详细说明，但可以通过命令行选项推断或检查 `claudesync.local.json` 文件来配置。\n特定的项目文件（例如 `package.json`）会被视为构成子模块的标志。通过合理划分子模块，可以仅同步相关部分的代码，从而优化 token 使用。",{"id":119,"question_zh":120,"answer_zh":121,"source_url":113},24315,"为什么有时候需要执行两次项目创建或设置命令才能成功推送？","这是一个已知的偶发问题。在某些情况下（特别是直接在 Claude 网站创建了项目后），首次执行 `claudesync organization set` 和 `claudesync project set` 可能无法正确激活提供者。\n解决方案是：在同一个目录下再次运行相同的设置命令（即执行两次），之后即可正常执行 `claudesync push`。",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},24316,"macOS 用户使用 Anaconda 环境运行时出现 Traceback 错误怎么办？","如果在 macOS (如 v14.6) 的 Anaconda 环境中运行 `claudesync organization select` 或 `ls` 时出现 Python Traceback 错误，通常是因为底层 API 请求失败导致的连锁反应。\n请优先参考 403 错误的解决方案：\n1. 尝试切换登录提供者：`claudesync api login claude.ai-curl`。\n2. 确保已完全卸载并重新安装最新版本，遵循屏幕提示操作。\n3. 确认系统上的 Chrome 浏览器是否为最新版本，因为某些提供者依赖浏览器的 Cookie 或环境。","https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fissues\u002F24",{"id":128,"question_zh":129,"answer_zh":130,"source_url":113},24317,"如何查看当前的配置文件内容？","您可以运行以下命令来查看当前的配置详情，包括 API URL、压缩算法和文件分类模式等：\n`claudesync config ls`\n该命令会以 JSON 格式输出配置，帮助您诊断文件同步范围或 API 地址设置是否正确。",[132,137,142,147,152,157,162,167,172,177,182,187,192,197,202,207,212,217,222,227],{"id":133,"version":134,"summary_zh":135,"released_at":136},153803,"v0.7.6","## 变更内容\n* 修复：在 SessionKeyManager 和 config.local 中尊重 ssh_key_path 配置。由 @cchervitz 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F139 中完成\n* 杂项：准备 0.7.6 版本。由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F141 中完成\n\n## 新贡献者\n* @cchervitz 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F139 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.7.5...v0.7.6","2026-03-08T07:54:47",{"id":138,"version":139,"summary_zh":140,"released_at":141},153804,"v0.7.5","## 变更内容\n* 修复：更新聊天消息 API，使其与当前 Claude.ai 的格式保持一致，由 @sgasser 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F137 中完成\n* 为 `project set` 命令添加 `--project-id` 选项，由 @sgasser 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F135 中完成\n\n## 新贡献者\n* @sgasser 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F137 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.7.4...v0.7.5","2025-12-01T17:31:13",{"id":143,"version":144,"summary_zh":145,"released_at":146},153805,"v0.7.4","## 变更内容\n* 修复：工作流不包含权限，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F133 中完成\n* 新增功能：添加 Claude 代码网页会话 API，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F134 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.7.3...v0.7.4","2025-11-16T09:27:33",{"id":148,"version":149,"summary_zh":150,"released_at":151},153806,"v0.7.3","## 变更内容\n* 由 @tolland 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F130 中添加的 push 命令简易干运行模式\n* 杂项：更新 pyproject.toml 文件并移除已弃用的导入，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F132 中完成\n\n## 新贡献者\n* @tolland 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F130 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv.0.7.2...v0.7.3","2025-06-28T17:35:27",{"id":153,"version":154,"summary_zh":155,"released_at":156},153807,"v.0.7.2","## 变更内容\n* API 域名由 api.claude.ai 更换为 claude.ai，由 @kamartem 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F127 中完成\n* 修复：支持 Claude Max，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F129 中完成\n\n## 新贡献者\n* @kamartem 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F127 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.7.1...v.0.7.2","2025-06-12T15:12:11",{"id":158,"version":159,"summary_zh":160,"released_at":161},153808,"v0.7.1","## 变更内容\n* 文本嵌入生成，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F115 中实现\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.7.0...v0.7.1","2025-02-01T12:27:54",{"id":163,"version":164,"summary_zh":165,"released_at":166},153809,"v0.7.0","## 变更内容\n* 功能新增：支持通过 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F106 中指定聊天模型\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.9...v0.7.0","2025-01-11T08:44:37",{"id":168,"version":169,"summary_zh":170,"released_at":171},153810,"v0.6.9","## 变更内容\n* 功能：新增项目初始化，由 @jahwag 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F103 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.8...v0.6.9","2024-12-22T10:33:31",{"id":173,"version":174,"summary_zh":175,"released_at":176},153811,"v0.6.8","## 变更内容\n* 修复：升级命令\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.7...v0.6.8\n","2024-12-21T23:34:21",{"id":178,"version":179,"summary_zh":180,"released_at":181},153812,"v0.6.7","## 变更内容\n* 由 @crippledgeek 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F98 中更新了 renovate.yml\n* 新特性：由 @guidodinello 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F100 中实现了单个项目截断命令\n\n## 新贡献者\n* @guidodinello 在 https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F100 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.6...v0.6.7","2024-12-20T20:19:14",{"id":183,"version":184,"summary_zh":185,"released_at":186},153813,"v0.6.6","## What's Changed\r\n* feat: add login options by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F97\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.5...v0.6.6","2024-11-30T18:48:38",{"id":188,"version":189,"summary_zh":190,"released_at":191},153814,"v0.6.5","## What's Changed\r\n* Feature\u002Frenovate bot by @crippledgeek in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F90\r\n* fix: remove anthropic library by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F96\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.4...v0.6.5","2024-11-30T16:06:27",{"id":193,"version":194,"summary_zh":195,"released_at":196},153815,"v0.6.4","## What's Changed\r\n* fix: correct windows-style paths on submodules by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F88\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.3...v0.6.4","2024-11-07T20:53:04",{"id":198,"version":199,"summary_zh":200,"released_at":201},153816,"v0.6.3","## What's Changed\r\n* fix: pin anthropic version, count_tokens was replaced with $ api by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F87\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.2...v0.6.3","2024-11-07T19:57:26",{"id":203,"version":204,"summary_zh":205,"released_at":206},153817,"v0.6.2","# Changelog\r\n\r\n## [v0.6.2] - 2024-10-23\r\n\r\n### Features\r\n- Add project location presentation functionality\r\n- Add support for archiving all projects\r\n\r\n### Bug Fixes\r\n- Improve order of error messages in validate_and_get_provider\r\n- Fix config.local.json creation in .claudesync of custom directory  ([#74](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F85))\r\n- Enhance set logging functionality\r\n\r\n### Full Changelog\r\n[v0.6.1...v0.6.2](https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.1...v0.6.2)","2024-10-23T21:41:00",{"id":208,"version":209,"summary_zh":210,"released_at":211},153818,"v0.6.1","## What's Changed\r\n* Update README.md by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F71\r\n* fix: deprecate rsa by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F73\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.6.0...v0.6.1","2024-09-20T21:32:06",{"id":213,"version":214,"summary_zh":215,"released_at":216},153819,"v0.6.0","## What's Changed\r\n* feat: added logging of token count on push by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F68\r\n* feat: Encrypt session keys with SSH key for improved security by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F69\r\n\r\n**NOTE:** This release contains breaking changes. It is therefore advisable to delete ~\u002F.claudesync to have a fresh install.\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.5.7...v0.6.0","2024-09-14T10:09:25",{"id":218,"version":219,"summary_zh":220,"released_at":221},153820,"v0.5.7","## What's Changed\r\n\r\n* fix: exclude ~\u002F.claudesync from find_local_config_dir results by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F67\r\n  * Add check to prevent ~\u002F.claudesync from being returned as local config dir\r\n  * Update docstring to reflect new exclusion criteria\r\n  * Added codeowners\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.5.6...v0.5.7\r\n","2024-09-12T21:02:39",{"id":223,"version":224,"summary_zh":225,"released_at":226},153821,"v0.5.6","## What's Changed\r\n* Set command should take provider as option. Updated chat to work with config.local.json. by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F60\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.5.5...v0.5.6","2024-08-31T13:34:00",{"id":228,"version":229,"summary_zh":230,"released_at":231},153822,"v0.5.5","## What's Changed\r\n* Compression algorithms and packing by @jahwag in https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fpull\u002F59\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fjahwag\u002FClaudeSync\u002Fcompare\u002Fv0.5.4...v0.5.5","2024-08-30T19:56:06"]