DuckCoding - AI 编程工具统一管理平台

<div align="center">

一键安装与配置 Claude Code / CodeX / Gemini CLI 的跨平台桌面应用

</div>

English version: README_EN.md

目录

• 项目概览
• 核心功能
• 功能预览
• DuckCoding vs 手动配置
• 快速开始
• 使用指南（场景）
• 功能详解
• 设计与架构
• 常见问题（FAQ）
• 开发指南
• 配置文件说明
• 隐私与安全 / 许可证 / 相关链接 / Star History

项目概览

• 统一管理 Claude Code、CodeX、Gemini CLI，自动识别 npm/brew/官方安装方式
• 多环境实例（Local/WSL/SSH），集中检测、安装、更新与状态查看
• 多配置隔离（Profile），仅替换 API 字段，原生其他设置全部保留
• 三工具独立透明代理，会话级配置、历史记录、自启动、防回环
• 余额监控与供应商管理，模板 + 自定义提取器
• 全量本地存储（~/.duckcoding）

核心功能

• 工具管理：自动检测/安装/更新；支持 Local/WSL/SSH；识别安装方式并校验版本
• 配置管理（Profile）：多配置隔离；原生同步仅替换 API Key / Base URL
• 透明代理：三工具独立端口（8787/8788/8789）；会话级配置；自启动；回环检测
• 余额监控：多供应商；预设模板（NewAPI、OpenAI）+ 自定义 JS 提取器；可配置自动刷新
• 供应商管理：统一 API 供应商配置，Dashboard 一键切换与校验
• 高级设置：开机自启、单实例、日志级别/格式/文件输出

功能预览

<div align="center">

</div>

DuckCoding vs 手动配置

| 能力 | 手动配置 | DuckCoding | | ------------- | -------------------------- | -------------------------------- | | 工具安装/更新 | 手动执行 npm/brew/官方命令 | 一键安装与版本检测 | | 配置切换 | 手改 JSON/TOML/ENV | UI 一键切换，Profile 隔离 | | 多环境 | 逐一配置 | 统一管理 Local/WSL/SSH | | 代理 | 修改配置要重启 | UI 启停，三工具独立代理，防回环 | | 余额监控 | 自写脚本调用 API | 预设模板 + 自定义提取器 + 可视化 | | 学习成本 | 需理解各工具配置格式 | 图形界面 + 版本化新手引导 |

快速开始

1. 下载
   前往 Releases 获取最新包：https://github.com/DuckCoding-dev/DuckCoding/releases

• macOS Universal: DuckCoding-macOS-Universal.dmg
• Windows x64: DuckCoding-Windows-x64-setup.exe（推荐）或 .msi
• Linux x64: .deb / .rpm / .AppImage

2. 平台支持

• 支持：Windows 10/11 x64、macOS 10.15+（Inte...