🚀 专业的 Claude Code 桌面管理工具 - 现代化、高效、功能完备的 GUI 工具包
Any Code 是一个为 AI 驱动的代码开发工作流量身打造的专业桌面应用，同时支持 Claude Code CLI 和 OpenAI Codex 双引擎。提供完整的项目管理、会话控制、成本追踪、智能翻译和高级功能扩展。通过直观的可视化界面和创新的双引擎架构，让您更高效地使用 AI 进行辅助开发。
- ✅ 双引擎架构 - 支持 Claude Code 和 OpenAI Codex 双引擎，一键切换，无缝集成
- ✅ 完整的会话管理 - 多标签页会话、历史记录、实时流式输出、跨引擎统一管理
- ✅ 精确的成本追踪 - 多模型定价、Token 统计、使用分析仪表板、成本优化建议
- ✅ 强大的扩展系统 - MCP 集成、Hooks 自动化、Claude 扩展管理、自定义工具
- ✅ 智能翻译中间件 - 中英文透明翻译、渐进式翻译、翻译缓存、8 种内容提取策略
- ✅ 自动上下文管理 - 智能监控、自动压缩、Token 优化、压缩历史管理
- ✅ 开发者友好 - Git 集成、代码上下文搜索、Slash 命令、多项目管理
- ✅ 现代化 UI/UX - 深色/浅色主题、流畅动画、响应式设计、国际化支持
|
Claude Code CLI 引擎
OpenAI Codex 引擎
|
统一会话管理
智能引擎选择
|
|
可视化项目管理
多标签页会话
|
实时流式输出
高级会话控制
|
|
精确计费
详细统计
|
使用分析仪表板
成本优化建议
|
-
完整的 MCP 服务器管理
- 添加/删除/配置 MCP 服务器
- 支持 stdio 和 SSE 传输协议
- 从 Claude Desktop 导入配置
- 连接状态监控和测试
- 项目级和用户级配置
-
MCP 服务器市场
- 内置常用 MCP 服务器模板
- 一键安装流行服务器
- 自定义服务器配置
- 环境变量管理
管理和查看 Claude Code 扩展生态：
-
Plugins 查看器
- 已安装插件列表
- 组件统计和依赖关系
- 插件配置编辑
- 一键打开插件文件
-
Subagents 管理
- 浏览专用子代理
- 查看代理配置
- 编辑代理行为
- 代理性能统计
-
Agent Skills 查看
- AI 技能列表和描述
- 技能配置参数
- 技能启用/禁用
- 自定义技能开发
📚 官方资源: Plugins 文档 | Anthropic Skills 仓库 (13.7k ⭐)
-
智能 Hook 模板
- 提交前代码审查
- 安全漏洞扫描
- 性能优化检查
- 自定义审查规则
-
Hook 链执行
- 多 Hook 串联执行
- 条件触发和过滤
- 错误处理和重试
- 执行日志和报告
-
预定义场景
- 严格质量门禁
- 安全优先模式
- 性能监控模式
- 自动化测试集成
-
语义代码搜索
- 基于 MCP 的智能搜索
- 项目预索引加速
- 上下文增强提示
- 相关代码自动关联
-
增强型提示词
- 自动补充相关上下文
- 减少不必要的 Token 消耗
- 提高 Claude 理解准确度
- 优化响应质量
|
透明翻译工作流
核心特性
|
渐进式翻译系统 🆕
|
|
配置选项
|
性能优化
统计和监控
|
|
智能监控系统
自动压缩触发
|
压缩策略配置
压缩历史管理
性能和统计
|
-
主题系统
- 深色/浅色主题切换
- 顶栏快速切换按钮
- 自动保存用户偏好
- 平滑过渡动画
-
国际化支持
- 简体中文 / English
- 一键切换语言
- 完整的界面翻译
- 持久化语言设置
-
响应式设计
- 适配不同屏幕尺寸
- 紧凑高效的布局
- 清晰的视觉层次
- 无障碍访问支持
-
流畅动画
- Framer Motion 驱动
- 页面转场效果
- 微交互反馈
- 性能优化的渲染
- 操作系统: Windows 10/11、macOS 10.15+、Linux (Ubuntu 20.04+)
- Claude Code: 需要安装 Claude Code CLI
- 磁盘空间: 至少 200MB 可用空间
从 Releases 下载对应平台的安装包：
Windows 安装
方式一：MSI 安装包（推荐）
- 下载
.msi文件 - 双击运行安装程序
- 按照向导完成安装
方式二：NSIS 安装包
- 下载
.exe文件 - 以管理员身份运行
- 选择安装路径
方式三：便携版
- 下载
.zip压缩包 - 解压到任意目录
- 运行
Any Code.exe
macOS 安装
支持架构: Apple Silicon (ARM64) + Intel (x86_64)
方式一：DMG 安装包（推荐）
- 下载
.dmg文件 - 双击挂载磁盘映像
- 拖拽应用到 Applications 文件夹
方式二：APP 应用包
- 下载
.app.tar.gz文件 - 解压并移动到 Applications
如果安装后提示 "Any Code" 已损坏，无法打开 或 "无法验证开发者"，请在终端执行：
# 方法 1：移除隔离属性（推荐，最简单）
sudo xattr -r -d com.apple.quarantine "/Applications/Any Code.app"
# 方法 2：清除所有扩展属性
xattr -cr "/Applications/Any Code.app"
# 方法 3：重新签名应用（如果上述方法不生效）
sudo codesign --force --deep --sign - "/Applications/Any Code.app"💡 提示: 如果应用安装在其他位置，请将
/Applications/Any Code.app替换为实际路径。
原因: macOS Gatekeeper 默认会阻止未经 Apple 公证的应用。这是正常的安全机制，执行上述命令后即可正常使用。
Linux 安装
方式一：AppImage（推荐）
# 下载 AppImage 文件
chmod +x Claude-Workbench-*.AppImage
# 运行应用
./Claude-Workbench-*.AppImage方式二：DEB 包 (Debian/Ubuntu)
sudo dpkg -i any-code-*.deb
sudo apt-get install -f # 修复依赖方式三：RPM 包 (Fedora/RHEL)
sudo rpm -i any-code-*.rpm# 1. 克隆仓库
git clone https://github.com/anyme123/any-code.git
cd any-code
# 2. 安装依赖
npm install
# 3. 开发模式（热重载）
npm run tauri dev
# 4. 构建生产版本
npm run tauri build
# 5. 快速构建（开发版，速度更快）
npm run tauri:build-fast构建要求:
- Node.js 18.0+ (推荐 LTS)
- Rust 1.70+
- 平台特定工具链（WebView2 Runtime for Windows）
-
配置 Claude Code CLI
- 安装 Claude Code CLI
- 设置 API Key:
claude config set api_key YOUR_KEY - 验证安装:
claude --version
-
启动 Any Code
- 首次启动会自动检测 Claude CLI
- 如果未找到，会提示设置自定义路径
-
创建第一个会话
- 点击"新建会话"按钮
- 选择项目目录
- 开始与 Claude 对话
- 新建会话: 顶部工具栏点击
+按钮 - 切换会话: 点击标签页或使用
Ctrl+Tab(macOS:⌘+Tab) - 恢复会话: 从会话历史列表双击会话
- 关闭会话: 标签页关闭按钮或
Ctrl+W(macOS:⌘+W)
- 找到要撤回的用户消息
- 点击消息右侧的圆形撤回按钮
- 确认撤回操作
- 该消息及之后的所有对话将被删除
- 代码自动回滚到发送前状态
- 提示词恢复到输入框可修改
- 切换: 按
Shift+Tab或输入框右侧切换按钮 - 用途: 代码探索、方案设计、风险评估
- 特点: 不修改文件、不执行命令、只返回分析结果
-
基础显示: 输入框底部实时显示会话总成本
-
详细统计: 鼠标悬停查看完整成本分析
- Token 分类统计
- 会话时长
- API 执行时间
- Cache 效率
-
使用仪表板: 侧边栏"使用统计"查看全局分析
- 总成本和 Token 使用
- 按模型/项目/日期分析
- 趋势图表和导出
// ~/.claude/mcp_servers.json
{
"acemcp": {
"transport": "stdio",
"command": "acemcp",
"args": [],
"env": {
"ACEMCP_PROJECT_ROOT": "/path/to/project"
}
},
"filesystem": {
"transport": "stdio",
"command": "mcp-server-filesystem",
"args": ["/allowed/path"]
}
}// ~/.claude/settings.json
{
"hooks": {
"user-prompt-submit": {
"command": "echo 'Submitting prompt...'",
"enabled": true
},
"tool-result": {
"command": "custom-tool-handler.sh",
"enabled": true,
"filter": {
"tool_name": ["bash", "edit"]
}
}
}
}// 在设置中配置
{
"translation": {
"enabled": true,
"confidence_threshold": 0.7,
"cache_enabled": true,
"cache_ttl_hours": 24
}
}any-code/
├── .factory/ # Factory 配置（skills）
├── .github/workflows/ # GitHub Actions CI/CD 工作流
├── .vscode/ # VSCode 编辑器配置
├── dist/ # 前端构建输出目录
├── scripts/ # 构建和部署脚本
├── src/ # 前端源代码 (React + TypeScript)
│ ├── assets/ # 静态资源
│ ├── components/ # React 组件
│ │ ├── common/ # 通用组件
│ │ ├── dialogs/ # 对话框组件
│ │ ├── FloatingPromptInput/ # 浮动输入框组件
│ │ ├── layout/ # 布局组件
│ │ ├── message/ # 消息展示组件
│ │ ├── ToolWidgets/ # 工具小部件
│ │ ├── ui/ # 基础 UI 组件
│ │ └── widgets/ # 功能小部件
│ ├── contexts/ # React Context 状态管理
│ ├── hooks/ # 自定义 React Hooks
│ ├── i18n/locales/ # 国际化语言文件 (en.json, zh.json)
│ ├── lib/ # 工具库和服务
│ ├── types/ # TypeScript 类型定义
│ ├── App.tsx # 主应用组件
│ ├── main.tsx # 应用入口
│ └── styles.css # 全局样式
├── src-tauri/ # Rust 后端源代码 (Tauri)
│ ├── src/
│ │ ├── commands/ # Tauri 命令模块
│ │ │ ├── claude/ # Claude CLI 集成
│ │ │ ├── acemcp.rs # MCP 代码上下文搜索
│ │ │ ├── codex.rs # OpenAI Codex 集成
│ │ │ ├── storage.rs # SQLite 数据库操作
│ │ │ ├── translator.rs # 翻译服务
│ │ │ ├── provider.rs # API 代理商管理
│ │ │ ├── mcp.rs # MCP 服务器管理
│ │ │ ├── usage.rs # 使用统计和成本追踪
│ │ │ ├── prompt_tracker.rs # 提示词历史和回滚
│ │ │ ├── context_manager.rs # 自动上下文压缩
│ │ │ ├── enhanced_hooks.rs # Hooks 自动化系统
│ │ │ └── extensions.rs # 插件和扩展管理
│ │ └── main.rs # Rust 入口
│ ├── icons/ # 应用图标
│ ├── Cargo.toml # Rust 依赖配置
│ └── tauri.conf.json # Tauri 配置
├── package.json # npm 配置和依赖
├── tsconfig.json # TypeScript 配置
├── vite.config.ts # Vite 构建配置
├── index.html # HTML 入口
└── README.md # 项目文档
┌───────────────────────────────────────────────────────────────┐
│ Any Code │
├─────────────────────┬─────────────────┬───────────────────────┤
│ │ │ │
│ React 前端层 │ Tauri 桥接层 │ Rust 后端层 │
│ │ │ │
│ • React 18 + TS │ • IPC 通信 │ • 双引擎管理 │
│ • Tailwind CSS 4 │ • 安全调用 │ - Claude CLI 封装 │
│ • Framer Motion │ • 类型安全 │ - Codex API 集成 │
│ • i18next │ • 事件系统 │ • 进程管理 │
│ • Radix UI │ • 资源管理 │ • 会话控制 │
│ • Custom Hooks │ • 流式传输 │ • 文件操作 │
│ │ │ • Git 集成 │
│ │ │ • SQLite 存储 │
│ │ │ • MCP 管理 │
│ │ │ • 翻译服务 │
│ │ │ • 上下文管理 │
└─────────────────────┴─────────────────┴───────────────────────┘
▲ ▲ ▲
│ │ │
└─────────────────────┴─────────────────────┘
IPC 事件流
┌──────────────────┐ ┌──────────────────┐
│ Claude Code CLI │ │ OpenAI Codex │
│ • Agent SDK │ │ • Codex API │
│ • MCP Servers │ │ • JSON Stream │
│ • Tools & Exts │ │ • Multi-mode │
└──────────────────┘ └──────────────────┘
| 技术 | 版本 | 用途 |
|---|---|---|
| React | 18.3.1 | UI 框架 |
| TypeScript | 5.9.3 | 类型安全 |
| Tailwind CSS | 4.1.8 | 样式框架 |
| Framer Motion | 12.23.24 | 动画系统 |
| i18next | 25.6.0 | 国际化 |
| Radix UI | Latest | 组件库 |
| React Markdown | 9.0.3 | Markdown 渲染 |
| React Syntax Highlighter | 15.6.1 | 代码高亮 |
| date-fns | 3.6.0 | 日期处理 |
| Zod | 3.24.1 | 数据校验 |
| @tauri-apps/api | 2.9.0 | Tauri 前端 API |
| 技术 | 版本 | 用途 |
|---|---|---|
| Tauri | 2.9 | 桌面应用框架 |
| Rust | 2021 Edition | 系统编程语言 |
| SQLite | 0.32 (rusqlite) | 嵌入式数据库 |
| Tokio | 1.x | 异步运行时 |
| Serde | 1.x | 序列化/反序列化 |
| Reqwest | 0.12 | HTTP 客户端 |
| Chrono | 0.4 | 时间处理 |
| anyhow | 1.x | 错误处理 |
| regex | 1.x | 正则表达式 |
| uuid | 1.6 | UUID 生成 |
| 组件/模块 | 位置 | 功能描述 |
|---|---|---|
| AppLayout | layout/ |
应用主布局和导航 |
| ClaudeCodeSession | components/ |
Claude 会话管理核心 |
| ExecutionEngineSelector | components/ |
引擎切换器（Claude/Codex） |
| FloatingPromptInput | components/ |
浮动输入框组件 |
| AIMessage / UserMessage | message/ |
消息展示组件 |
| StreamMessageV2 | message/ |
流式消息渲染 |
| ToolCallsGroup | message/ |
工具调用展示 |
| SubagentMessageGroup | message/ |
子代理消息组 |
| MCPManager | components/ |
MCP 服务器管理 |
| UsageDashboard | components/ |
使用统计仪表板 |
| TranslationSettings | components/ |
翻译配置组件 |
| Hook | 功能描述 |
|---|---|
| usePromptExecution | 提示词执行逻辑（最核心） |
| useMessageTranslation | 消息翻译处理 |
| useSessionLifecycle | 会话生命周期管理 |
| useSessionCostCalculation | 成本计算 |
| useTabs | 多标签页管理 |
| useDisplayableMessages | 消息展示处理 |
| useKeyboardShortcuts | 键盘快捷键 |
用户操作 → React 组件 → Tauri Command
↓
Rust 后端处理
↓
┌─────────────────┼─────────────────┬─────────────────┐
▼ ▼ ▼ ▼
文件系统操作 Claude CLI 调用 Codex API 调用 数据库操作
│ │ │ │
└─────────────────┴─────────────────┴─────────────────┘
↓
IPC 事件返回（流式）
↓
┌────────────┴────────────┐
▼ ▼
翻译中间件处理 原始消息处理
│ │
└────────────┬────────────┘
▼
React 状态更新
↓
┌────────────┴────────────┐
▼ ▼
UI 重新渲染 上下文监控
↓
自动压缩检测
-- 使用统计表
CREATE TABLE usage_entries (
id INTEGER PRIMARY KEY,
session_id TEXT NOT NULL,
timestamp TEXT NOT NULL,
model TEXT NOT NULL,
input_tokens INTEGER,
output_tokens INTEGER,
cache_creation_tokens INTEGER,
cache_read_tokens INTEGER,
total_tokens INTEGER,
cost REAL,
project_path TEXT,
created_at TEXT DEFAULT CURRENT_TIMESTAMP
);
-- 性能索引
CREATE INDEX idx_usage_session_id ON usage_entries(session_id);
CREATE INDEX idx_usage_timestamp ON usage_entries(timestamp DESC);
CREATE INDEX idx_usage_project_path ON usage_entries(project_path);
CREATE INDEX idx_usage_model_timestamp ON usage_entries(model, timestamp DESC);前端通过 src/lib/api.ts 封装了所有 Tauri 命令调用：
| 分类 | 主要接口 | 功能描述 |
|---|---|---|
| 项目管理 | listProjects(), getProjectSessions(), deleteSession() |
项目和会话的 CRUD 操作 |
| Claude 执行 | executeClaudeCode(), continueClaudeCode(), resumeClaudeCode(), cancelClaudeExecution() |
Claude CLI 调用和控制 |
| Codex 执行 | executeCodex(), resumeCodex(), listCodexSessions() |
OpenAI Codex API 调用 |
| 存储管理 | storageListTables(), storageExecuteSql(), storageInsertRow() |
SQLite 数据库操作 |
| MCP 管理 | mcpAdd(), mcpList(), mcpTestConnection() |
MCP 服务器配置和测试 |
| 翻译服务 | translate(), getTranslationConfig(), clearTranslationCache() |
翻译中间件接口 |
| 使用统计 | getUsageStats(), getUsageByModel(), getUsageByProject() |
成本和 Token 统计 |
| 上下文管理 | compressContext(), getCompressionHistory() |
自动上下文压缩 |
| 特点 | 描述 |
|---|---|
| 双引擎架构 | 同时支持 Claude Code CLI 和 OpenAI Codex，一键切换 |
| 现代化技术栈 | Tauri 2.9 + React 18 + Rust 2021，跨平台高性能 |
| 流式渲染 | IPC 事件流驱动，实时流式输出 AI 响应 |
| 嵌入式存储 | SQLite WAL 模式，高性能本地数据持久化 |
| 翻译中间件 | 透明的中英文翻译，8 种内容提取策略 |
| 自动上下文管理 | 智能监控和压缩，优化 Token 使用 |
| 扩展生态 | MCP 协议支持、Hooks 自动化、插件系统 |
- ✨ OpenAI Codex 集成 - 全新的双引擎架构，支持 Claude 和 Codex 双引擎切换
- 支持 Full Auto、Danger Full Access、Read-only 三种执行模式
- JSON 格式流式输出，完整的会话管理
- 独立的 Codex 会话历史和恢复功能
- 可配置模型和输出 Schema
- ✨ 增强的翻译系统 - 全面重构的翻译中间件
- 8 种智能内容提取策略
- 渐进式历史消息后台翻译
- 优先级翻译队列（高优先级处理最近消息）
- 翻译状态实时追踪和显示
- ✨ 自动上下文管理 - 智能的上下文压缩和优化
- 自动监控会话 Token 使用
- 智能触发上下文压缩
- 压缩历史记录和统计
- 可配置的压缩策略
- ✅ 多引擎会话列表统一展示（Claude + Codex）
- ✅ 引擎特定的图标和标识
- ✅ 改进的会话生命周期管理
- ✅ 增强的消息翻译 Hook 系统
- ✅ 优化的 Token 计数和成本追踪
- ✅ 统一的错误处理和日志系统
- ✅ 执行引擎选择器（Claude / Codex）
- ✅ 会话类型可视化标识
- ✅ 改进的输入框和工具栏布局
- ✅ 更清晰的状态指示器
- ✅ 优化的响应式设计
- ✅ 重构的会话加载逻辑，加载速度提升 60%
- ✅ 优化的翻译缓存机制
- ✅ 减少不必要的组件重渲染
- ✅ 改进的事件监听器管理
- ✅ 数据库查询优化
- 🔧 修复子代理消息渲染导致的页面崩溃问题
- 🔧 修复翻译功能的取消机制
- 🔧 修复会话切换时的内存泄漏
- 🔧 修复 Codex 集成中的控制台窗口闪现问题
- 🔧 清理死代码和冗余 API
v4.3.x 更新历史
- 修复 AppLayout 中 ThemeToggle 组件的 props 类型错误
- 修复构建失败问题，确保 CI/CD 正常运行
- 版本号统一更新到 4.3.7
- 所有平台配置文件同步更新
- Claude 扩展管理器（Plugins/Subagents/Skills）
- 多模型精确成本计算
- Git 代码变更统计 API
- Acemcp 代码上下文搜索集成
- 默认浅色主题，更护眼
- SQLite WAL 模式启用，数据库性能提升
我们欢迎各种形式的贡献！无论是 Bug 报告、功能建议还是代码提交。
# 1. Fork 并克隆仓库
git clone https://github.com/YOUR_USERNAME/any-code.git
cd any-code
# 2. 安装依赖
npm install
# 3. 创建功能分支
git checkout -b feature/your-feature-name
# 4. 启动开发服务器
npm run tauri dev
# 5. 进行更改并测试
# 6. 提交更改
git add .
git commit -m "feat: add your feature description"
# 7. 推送到 Fork
git push origin feature/your-feature-name
# 8. 创建 Pull RequestTypeScript/React
- 使用 TypeScript 严格模式
- 遵循 React Hooks 最佳实践
- 组件使用函数式组件 + Hooks
- Props 使用明确的类型定义
- 使用 ESLint 和 Prettier 格式化
Rust
- 遵循 Rust 2021 Edition 标准
- 使用
cargo fmt格式化代码 - 使用
cargo clippy检查代码质量 - 错误处理使用
Result和anyhow - 异步代码使用
tokio
提交信息规范
<type>(<scope>): <subject>
<body>
<footer>
类型:
feat: 新功能fix: Bug 修复docs: 文档更新style: 代码格式（不影响代码运行）refactor: 重构（既不是新功能，也不是 Bug 修复）perf: 性能优化test: 测试相关chore: 构建过程或辅助工具的变动
提交 Issue 时请包含：
- 详细的问题描述
- 复现步骤
- 预期行为 vs 实际行为
- 系统环境信息
- 相关截图或日志
Q: 应用无法启动或闪退
A: 检查以下几点：
- 确认 Claude Code CLI 已正确安装
- 检查系统是否安装了必要的运行时（Windows: WebView2 Runtime）
- 查看应用日志文件（位置见下方）
- 尝试以管理员/root 权限运行
日志位置：
- Windows:
%APPDATA%\any-code\logs - macOS:
~/Library/Application Support/any-code/logs - Linux:
~/.config/any-code/logs
Q: Claude Code CLI 未找到
A:
- 确认 Claude Code CLI 已安装:
claude --version - 在设置中手动指定 Claude CLI 路径
- 确保 PATH 环境变量包含 Claude CLI 安装目录
Q: 会话无法加载或历史记录丢失
A:
- 检查
~/.claude/projects/目录权限 - 确认 JSONL 文件没有损坏
- 尝试重启应用
- 查看应用日志获取详细错误信息
Q: MCP 服务器连接失败
A:
- 确认 MCP 服务器正确安装
- 检查配置文件路径和命令是否正确
- 测试手动运行 MCP 服务器命令
- 查看服务器日志获取错误信息
Q: 翻译功能不工作
A:
- 在设置中确认翻译中间件已启用
- 检查网络连接
- 尝试清除翻译缓存
- 重新初始化翻译服务
本项目基于 AGPL-3.0 开源协议发布。
这意味着：
- ✅ 可以自由使用、修改和分发
- ✅ 必须开源修改后的代码
- ✅ 网络服务也需要开源
- ✅ 必须保留版权和许可声明
详见 LICENSE 文件。
- MCP 协议规范 - Model Context Protocol
- Claude Code GitHub Discussions
我们欢迎任何形式的反馈和建议！
- 💡 功能建议
- 🐛 Bug 报告
- 📝 文档改进
- 🌍 翻译贡献
感谢以下项目和社区：
如果这个项目对您有帮助，请给我们一个 Star ⭐！
Any Code - 让 Claude Code 更好用
Made with ❤️ by the Any Code Team
![@factory-droid[bot]](https://avatars.githubusercontent.com/in/358017?s=64&v=4){kind=small}
