克劳德同步
非官方TypeScript SDK包装 claude.ai 网页API。将您的对话、工件和项目知识导出为git存储库。
> 你的数据,你的方式。 ClaudeSync是一个社区工具。它不隶属于Anthropic或得到Anthropics的认可。使用风险自负——访问未经证明的网站API可能会违反Anthropic的服务条款,并可能导致帐户暂停。
快速安装
CLI(bash、zsh、fish)```sh
curl -fsSL https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install.sh | sh
### CLI(PowerShell/Windows)```powershell
irm https://raw.githubusercontent.com/InfiniteRoomLabs/claudesync/main/scripts/install.ps1 | iex
MCP服务器(克劳德代码/克劳德桌面)```sh
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
### 卸载```sh
# 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”文件系统
用法
命令行界面```sh
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 --json
### MCP 服务器
安装后,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` |下载工件文件|
### 码头工人```sh
# 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 值,然后:```sh
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 (用于发展)
发展```sh
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的服务条款。作者对使用此工具的任何后果不承担任何责任,包括但不限于账户暂停。
