克劳德同步
非官方TypeScript SDK包装 claude.ai 网页API。将您的对话、工件和项目知识导出为git存储库。
你的数据,你的方式。 ClaudeSync是一个社区工具。它不隶属于Anthropic或得到Anthropics的认可。使用风险自负——访问未经证明的网站API可能会违反Anthropic的服务条款,并可能导致帐户暂停。
快速安装
CLI(bash、zsh、fish)
curl -fsSL https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install.sh | shCLI(PowerShell/Windows)
irm https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install.ps1 | iexMCP服务器(克劳德代码/克劳德桌面)
# Unix
curl -fsSL https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install-mcp.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install-mcp.ps1 | iex卸载
# Unix
curl -fsSL https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/uninstall.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/uninstall.ps1 | iex它的作用
ClaudeSync从Firefox(或Windows/macOS上的Chrome)读取您的会话cookie,并使用它访问claude.ai web API。它可以:
- 列出对话 包含型号、日期和项目信息
- 导出对话 作为git存储库(对话文本+工件)
- 搜索 所有对话(全文)
- 列出项目 并下载项目知识文件
- 列出并下载工件 从“wiggle”文件系统
用法
命令行界面
# List your conversations
claudesync ls
# Export a conversation to a git repo
claudesync export
claudesync export --output ./my-export
# Export as JSON bundle instead of git
claudesync export --format json
# Search conversations
claudesync search "typescript generics"
# List projects
claudesync projects
# All commands support --json for machine-readable output
claudesync ls --json
claudesync projects --jsonMCP 服务器
安装后,MCP服务器向Claude Code/Claude Desktop公开了8个工具:
| 工具 | 说明 |
|---|---|
list_organizations | 列出您的claude.ai组织 |
list_conversations | 列出带有元数据的对话 |
get_conversation | 获取所有消息的完整对话 |
search_conversations | 跨对话的全文搜索 |
list_projects | 列出您的项目 |
get_project_docs | 获取项目知识文件内容 |
list_artifacts | 列出对话的工件文件 |
download_artifact | 下载工件文件 |
码头工人
# CLI via Docker (manual cookie)
docker run --rm -e CLAUDE_AI_COOKIE='sessionKey=...' \
-v "$(pwd):/data" deathnerd/claudesync:latest ls
# MCP server via Docker
docker run --rm -i -e CLAUDE_AI_COOKIE='sessionKey=...' \
deathnerd/claudesync-mcp:latest认证
ClaudeSync读取您的 sessionKey cookie自动:
| 浏览器 | 平台 | 方法 |
|---|---|---|
| Firefox | Linux、macOS | 阅读 cookies.sqlite 直接(标准、Snap、Flatpak路径) |
| Chrome | Windows | DPAPI解密(本机,无外部deps) |
| Chrome | macOS | 通过钥匙链访问 security CLI |
| Chrome | Linux | 不自动支持--使用 pycookiecheat 或手动粘贴 |
| 任意 | 任意 | 集合 CLAUDE_AI_COOKIE env-var手动 |
手动方法: 打开claude.ai,按F12,转到应用程序>Cookie>claude.ai,复制 sessionKey 值,然后:
# Unix
export CLAUDE_AI_COOKIE='sessionKey=
'
# PowerShell
$env:CLAUDE_AI_COOKIE = 'sessionKey=
'建筑
Consumers: CLI | MCP Server | (Firefox Extension -- future)
| |
Core SDK: @infinite-room-labs/claudesync-core (TypeScript)
Auth | API Client | Export Engine | Message Tree
|
Transport: claude.ai Web API (undocumented, cookie auth)Monorepo软件包:
| 包装 | 描述 |
|---|---|
@infinite-room-labs/claudesync-core | SDK:身份验证、HTTP客户端、Zod模式、git导出引擎 |
@infinite-room-labs/claudesync-mcp-server | 带8个工具的MCP服务器(stdio传输) |
@infinite-room-labs/claudesync-cli | CLI工具(ls、导出、搜索、项目) |
需求
- Node.js v24+ (必填项——Cloudflare通过TLS指纹识别阻止Bun和curl)
- 码头工人 (适用于集装箱使用)
- sqlite3 CLI(用于在Unix上读取Firefox cookie)
- pnpm (用于发展)
发展
git clone https://github.com/InfiniteRoomLabs/claudesync.git
cd claudesync
pnpm install
pnpm build
pnpm test安装程序选项
所有安装脚本都支持:
| 标志 | 描述 |
|---|---|
--force / -f | 无需询问即可覆盖现有安装 |
| (无标志) | 替换现有文件前以交互方式提示 |
MCP安装程序还支持:
| 标志 | 描述 |
|---|---|
--target claude-code | 配置克劳德代码(跳过交互式菜单) |
--target claude-desktop | 为Claude桌面配置 |
--target mcp-json | 写项目级别 .mcp.json |
许可证
麻省理工学院
免责声明
ClaudeSync是一个非官方的、由社区构建的工具。它不隶属于Anthropic,也不受Anthropics的认可或支持。它使用您自己的会话凭据访问未记录的claude.ai web API以导出您自己的数据。使用此工具可能会违反Anthropic的服务条款。作者对使用此工具的任何后果不承担任何责任,包括但不限于账户暂停。
