Any Code

🚀 专业的 AI 代码助手桌面应用 - 多引擎、现代化、高效、功能完备的 GUI 工具包

📖 简介

Any Code 是一个为 AI 驱动的代码开发工作流量身打造的专业桌面应用，支持 Claude Code CLI、OpenAI Codex 和 Google Gemini CLI 三大 AI 引擎。提供完整的项目管理、会话控制、成本追踪、智能翻译和高级功能扩展。通过直观的可视化界面和创新的多引擎架构，让您更高效地使用 AI 进行辅助开发。

为什么选择 Any Code？

• ✅ 三引擎架构 - 支持 Claude Code、OpenAI Codex 和 Google Gemini 三大引擎，一键切换，无缝集成
• ✅ 完整的会话管理 - 多标签页会话、历史记录、实时流式输出、跨引擎统一管理
• ✅ 精确的成本追踪 - 多模型定价、Token 统计、使用分析仪表板、成本优化建议
• ✅ 强大的扩展系统 - MCP 集成、Hooks 自动化、Claude 扩展管理、自定义工具
• ✅ 智能翻译中间件 - 中英文透明翻译、渐进式翻译、翻译缓存、8 种内容提取策略
• ✅ 自动上下文管理 - 智能监控、自动压缩、Token 优化、压缩历史管理
• ✅ 开发者友好 - Git 集成、代码上下文搜索、Slash 命令、多项目管理
• ✅ 现代化 UI/UX - 深色/浅色主题、流畅动画、响应式设计、国际化支持

✨ 核心特性

🚀 三引擎架构 🆕

🎯 会话管理

💰 智能成本追踪

🔧 开发者工具

MCP (Model Context Protocol) 集成

• 完整的 MCP 服务器管理
• 添加/删除/配置 MCP 服务器
• 支持 stdio 和 SSE 传输协议
• 从 Claude Desktop 导入配置
• 连接状态监控和测试

• 项目级和用户级配置

• MCP 服务器市场

• 内置常用 MCP 服务器模板
• 一键安装流行服务器
• 自定义服务器配置
• 环境变量管理

Claude 扩展管理器 🆕

管理和查看 Claude Code 扩展生态：

• Plugins 查看器
• 已安装插件列表
• 组件统计和依赖关系
• 插件配置编辑

• 一键打开插件文件

• Subagents 管理

• 浏览专用子代理
• 查看代理配置
• 编辑代理行为

• 代理性能统计

• Agent Skills 查看

• AI 技能列表和描述
• 技能配置参数
• 技能启用/禁用
• 自定义技能开发

📚 官方资源: Plugins 文档 | Anthropic Skills 仓库 (13.7k ⭐)

Hooks 自动化系统

• 智能 Hook 模板
• 提交前代码审查
• 安全漏洞扫描
• 性能优化检查

• 自定义审查规则

• Hook 链执行

• 多 Hook 串联执行
• 条件触发和过滤
• 错误处理和重试

• 执行日志和报告

• 预定义场景

• 严格质量门禁
• 安全优先模式
• 性能监控模式
• 自动化测试集成

代码上下文搜索 (Acemcp)

• 语义代码搜索
• 基于 MCP 的智能搜索
• 项目预索引加速
• 上下文增强提示

• 相关代码自动关联

• 增强型提示词

• 自动补充相关上下文
• 减少不必要的 Token 消耗
• 提高 Claude 理解准确度
• 优化响应质量

🌐 智能翻译中间件 ✨ 重构增强

🧠 自动上下文管理 🆕

🎨 现代化 UI/UX

• 主题系统
• 深色/浅色主题切换
• 顶栏快速切换按钮
• 自动保存用户偏好

• 平滑过渡动画

• 国际化支持

• 简体中文 / 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 安装包（推荐） 1. 下载 .dmg 文件 2. 双击挂载磁盘映像 3. 拖拽应用到 Applications 文件夹

方式二：APP 应用包 1. 下载 .app.tar.gz 文件 2. 解压并移动到 Applications

⚠️ 重要：解决 Gatekeeper 阻止

如果安装后提示 "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. 构建生产版本（会通过 build.ps1 加载签名环境变量）
npm run tauri:build

# 5. 快速构建（开发版，速度更快）
npm run tauri:build-fast

构建要求: - Node.js 18.0+ (推荐 LTS) - Rust 1.70+ - 平台特定工具链（WebView2 Runtime for Windows）

📖 使用指南

首次使用

1. 配置 Claude Code CLI
2. 安装 Claude Code CLI
3. 设置 API Key: claude config set api_key YOUR_KEY

4. 验证安装: claude --version

5. 配置 Gemini CLI（可选） 🆕

6. 安装 Gemini CLI: npm install -g @anthropic-ai/claude-code 或从 官方仓库 安装
7. 在应用中选择认证方式：
   • Google OAuth（推荐，免费层可用）
   • API Key（从 Google AI Studio 获取）
   • Vertex AI（企业级 Google Cloud）

8. 验证安装: gemini --version

9. 启动 Any Code

10. 首次启动会自动检测 Claude CLI 和 Gemini CLI

11. 如果未找到，会提示设置自定义路径

12. 创建第一个会话

13. 点击"新建会话"按钮
14. 选择项目目录
15. 选择使用的引擎（Claude/Codex/Gemini）
16. 开始与 AI 对话

核心功能使用

会话管理

• 新建会话: 顶部工具栏点击 + 按钮
• 切换会话: 点击标签页或使用 Ctrl+Tab (macOS: ⌘+Tab)
• 恢复会话: 从会话历史列表双击会话
• 关闭会话: 标签页关闭按钮或 Ctrl+W (macOS: ⌘+W)

提示词撤回

1. 找到要撤回的用户消息
2. 点击消息右侧的圆形撤回按钮
3. 确认撤回操作
4. 该消息及之后的所有对话将被删除
5. 代码自动回滚到发送前状态
6. 提示词恢复到输入框可修改

Plan Mode（只读分析模式）

• 切换: 按 Shift+Tab 或输入框右侧切换按钮
• 用途: 代码探索、方案设计、风险评估
• 特点: 不修改文件、不执行命令、只返回分析结果

成本追踪

• 基础显示: 输入框底部实时显示会话总成本
• 详细统计: 鼠标悬停查看完整成本分析
• Token 分类统计
• 会话时长
• API 执行时间

• Cache 效率

• 使用仪表板: 侧边栏"使用统计"查看全局分析

• 总成本和 Token 使用
• 按模型/项目/日期分析
• 趋势图表和导出

🔧 高级配置

MCP 服务器配置

// ~/.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"]
  }
}

Hooks 配置示例

// ~/.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"]
      }
    }
  }
}

Gemini 配置 🆕

// ~/.anycode/gemini/config.json
{
  "authMethod": "google_oauth",  // google_oauth | api_key | vertex_ai
  "defaultModel": "gemini-2.5-pro",
  "approvalMode": "auto_edit",   // auto_edit | yolo | default
  "apiKey": "YOUR_API_KEY",      // 仅 api_key 模式需要
  "googleCloudProject": "",      // 仅 vertex_ai 模式需要
  "env": {}
}

支持的 Gemini 模型： | 模型 ID | 名称 | 上下文窗口 | |---------|------|-----------| | gemini-3-pro-preview | Gemini 3 Pro (Preview) | 1,000,000 | | gemini-2.5-pro | Gemini 2.5 Pro | 1,000,000 | | gemini-2.5-flash | Gemini 2.5 Flash | 1,000,000 | | gemini-2.0-flash-exp | Gemini 2.0 Flash (Experimental) | 1,000,000 |

翻译中间件配置

// 在设置中配置
{
  "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 集成
│   │   │   ├── codex/           # OpenAI Codex 集成
│   │   │   ├── gemini/          # Google Gemini CLI 集成 🆕
│   │   │   ├── acemcp.rs        # MCP 代码上下文搜索
│   │   │   ├── 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 │ • 事件系统 │ - Gemini CLI 集成 │ │ • Radix UI │ • 资源管理 │ • 进程管理 │ │ • Custom Hooks │ • 流式传输 │ • 会话控制 │ │ │ │ • 文件操作 │ │ │ │ • Git 集成 │ │ │ │ • SQLite 存储 │ │ │ │ • MCP 管理 │ │ │ │ • 翻译服务 │ │ │ │ • 上下文管理 │ └─────────────────────┴─────────────────┴───────────────────────┘ ▲