makecindy / makecindy/cindy

希望 Cindy 能复用系统已安装的 Claude Code,而不是只认 App 私有副本

Open
#3,760 1 comment 0 reactions 0 assignees View on GitHub
feature
Dominant language
TypeScript
Stars
2.7k
Forks
395
Avg merge
21h 48m
Merged PRs (30d)
776

Description

**提交人**: will slade
**客户端版本**: 0.1.69

---

## 使用场景

同一台机器上同时装了两套 Claude Code:一套是自己在终端里装的、在 PATH 上;另一套是 Cindy 自带的私有副本,放在 App 的 Application Support 目录下(按版本号建子目录)。平时在终端跑 `claude update` 保持 CLI 最新。

## 当前痛点

`claude update` 只升级 PATH 上那套,Cindy 私有目录不受影响,两边版本会持续漂移。实测:终端里 `claude --version` 已经是 2.1.258(版本目录下有 2.1.250 / 2.1.251 / 2.1.258 多个版本),Cindy 设置页「Claude Code 版本号」仍显示 2.1.247,私有目录下只有 2.1.247 这一个版本。

用户视角看不出这是两套安装,只会觉得「我明明升过级了,Cindy 里怎么还是旧版」,而且设置页没有任何入口能说明或改变这件事。上游 Claude Code 修的 bug、加的能力,在 Cindy 里要等 App 自己拉新版才能用。

## 诉求

当系统 PATH 上已经有可用且版本更高的 Claude Code 时,允许 Cindy 直接复用它,不必再维护一份私有副本。

## 建议方案

- 设置页增加一个 Claude Code 来源选项:内置副本 / 系统安装(可指定路径),默认可以保持内置以免影响普通用户。
- 选择系统安装时,启动时读一次 `claude --version` 校验可用性和最低版本要求,不满足就回退到内置副本并给出提示。
- 设置页的版本号旁边显示当前实际用的是哪一份(来源 + 版本),避免用户误以为只有一套。

## 已尝试的替代办法

手动把私有目录里的二进制换成新版。没有采用,原因是 Cindy 按目录名识别版本,直接替换会导致显示版本与实际版本不一致,也可能被后续自动更新覆盖。
---
**版本区域**: CN
**OS**: darwin arm64 (25.2.0)
**Harness**: Claude Code
**Model ID**: ` claude-opus-5 `
**界面语言**: zh-CN

Contributor guide

Open the contributing guide

Research direction

No files or tests are named. Start by tracing how Cindy locates its Claude Code executable, reads the version, and exposes the setting; then review the settings UI and startup validation flow. Done means users can select a system installation, see its source and version, and receive a fallback notice when it is unavailable or too old.

Written by the indexing model from the issue text.

Assessment

Tech stack
electron, typescript
Domain
desktop, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.