flowpad

flowpad 是一款本地优先的 AI 开发环境，由 Claude Code 驱动。它将 AI 辅助编程工作流直接运行在用户本地机器上，数据完全由用户掌控，无需将代码发送到云端。flowpad 以桌面应用为主，也提供 Python CLI 包，满足不同用户的使用习惯。

核心能力

flowpad 提供完整的本地 AI 开发环境，核心能力包括：

• 本地优先架构：所有 AI 交互和工具调用均在本地执行，代码和数据不离开用户机器；
• Claude Code 深度集成：通过 flow setup 命令自动配置 Claude Code，支持代码补全、文件编辑、任务自动化等能力；
• 开箱即用的桌面应用：提供 macOS、Windows、Linux 全平台桌面安装包，无需手动配置 Python 环境；
• CLI 包安装：支持 uv、pipx、pip 多种安装方式，适合喜欢命令行的开发者；
• Hook 钩子机制：支持将 flowpad hooks 注入到 Claude Code 设置中，实时追踪工作流事件；
• 后台服务管理：内置服务启动/停止/状态查询命令，方便管理本地 AI 开发服务；
• 跨平台认证：支持浏览器登录和 API Key 两种认证方式。

安装配置

flowpad 提供两种安装方式：

1. 桌面应用（推荐）：

   • macOS（Apple Silicon）：下载 Flowpad-arm64.dmg
   • macOS（Intel）：下载 Flowpad-x64.dmg
   • Windows：下载 Flowpad-Setup.exe
   • Linux：下载 AppImage/deb/rpm 安装包 桌面应用首次启动自动安装后端依赖，无需手动配置。

2. Python CLI 包（需要 Python 3.10+）：

   • 使用 uv（推荐）：uv tool install flowpad
   • 使用 pipx：pipx install flowpad
   • 使用 pip：pip install flowpad

使用步骤

flowpad 的典型使用流程：

1. 安装完成后启动服务： flow start 启动后访问 http://localhost:9007

2. 为 Claude Code 配置 flowpad： flow setup claude-code

3. 将 flow hooks 注入 Claude Code 设置（可选，用于实时追踪）： flow hooks set

4. 正常开始 AI 辅助开发，所有交互在本地安全执行。

5. 查看服务状态： flow status

6. 停止服务： flow stop

适用场景

• 在高安全要求环境（金融、医疗、政府代码库）中使用 AI 辅助编程；
• 开发者不希望代码上传到云端的隐私敏感项目；
• 需要在本地离线环境中使用 Claude Code 能力的场景；
• 团队中有严格数据合规要求的 AI 开发工作流；
• 个人开发者希望获得比纯 CLI 更友好界面的本地 AI 开发体验。

适用人群

• 对代码隐私有高要求的开发者；
• 企业内部需要合规使用 AI 编程工具的团队；
• 在安全隔离环境中工作的安全研究员和红队成员；
• 希望获得更友好桌面体验的 Claude Code 用户；
• 需要在多台机器间灵活切换 AI 开发环境的个人开发者。

工作原理

flowpad 在本地启动一个 HTTP 服务器（默认 localhost:9007），作为 Claude Code 与本地工具链之间的中间层。桌面应用版本会自动安装和管理这个后端服务，而 CLI 版本需要手动通过 flow start 启动。

flow hooks 机制通过修改 Claude Code 的配置文件，将 flowpad 的事件追踪器注入工作流中，使得 AI 助手的每一步操作都可以被本地记录和回放。所有数据（代码、提示词、AI 响应）都在本地流转，不经过任何第三方云服务。

官方链接

• PyPI：https://pypi.org/project/flowpad/
• GitHub（桌面应用）：https://github.com/langware-labs/flowpad