feat(ClaudeCode): 新增可执行路径设置与 Claude 设置文件快捷入口(Agentic Git 预置);#88
Merged
ThreeFish-AI merged 2 commits intoJul 10, 2026
Merged
Conversation
为 M5 AI 接缝铺路，新增两项 Claude Code 相关配置，仅承载「配置 + 快捷入口」，
agent/ 五接缝与 hyperGit.ai.enabled 行为不变、零破坏：
- 设置项 hyperGit.claudeCode.executablePath：Claude Code CLI 可执行路径，
留空=从 PATH 自动探测 claude；markdownDescription 内嵌 command: 链接就地
提供「浏览 / 打开 Claude 设置」。
- 命令 hyperGit.setClaudeCodePath：QuickPick(Browse 文件选择器写回 /
Use system Claude Code 清空覆盖)。
- 命令 hyperGit.openClaudeSettings：打开 ~/.claude/settings.json，缺失时经
用户确认后创建 {}。
采用原生设置 + 命令承载(零新增 Webview 面板)；路径解析下沉纯函数
engine/agent/claude-path.ts(Vitest 可测)，命令实现复用 misc-commands 范式。
check-types / lint / 372 单元测试全绿。
🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
- 新增功能文档 docs/features/claude-code-config.md(效果/设计 Mermaid/配置表/ 命令表/实现/与 Agentic Git 关系/验证)，并登记至文档中心与知识索引。 - README 双语指标校准为实际值(6 视图 · 101 命令 · 7 配置项 · 372 单元测试； 此前 97 命令 / 324 测试已滞后 HEAD)，并在 AI 接缝段补 pre-M5 铺垫说明。 - 设计文档就近最小同步：engineering-plan §6、implementation-status §5、 05-ai-agent-seams §阶段1 均补 pre-M5 已落地注记(不做 sofia.* 全量改名)。 - CHANGELOG Unreleased 补 Added 条目。 🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist) Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
ThreeFish-AI
changed the title
ThreeFish-AI
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
为 Hyper Git 的 Agentic Git（M5 AI Agent 能力，当前
agent/五接缝均为 Null 实现、hyperGit.ai.enabled仅占位）铺路，新增两项 Claude Code 相关的预置配置。本次仅落地「配置 + 快捷入口」，真正的 Claude Code 调用留待 M5 接缝实装，既有命令 / 视图 / 协议与hyperGit.ai.enabled行为均不变、零破坏。变更内容
hyperGit.claudeCode.executablePath（string，默认空）：指定 Claude Code CLI 可执行路径，留空 = 从PATH自动探测claude；markdownDescription内嵌command:链接，在设置页内就地提供「浏览可执行文件 / 打开 Claude 设置」两个动作。hyperGit.setClaudeCodePath：QuickPick——Browse for executable…（文件选择器写回设置）/Use system Claude Code（清空覆盖、回退 PATH 自动探测）。hyperGit.openClaudeSettings：打开~/.claude/settings.json；文件缺失时经用户确认后创建（mkdir -p+ 写入{}）。实现细节
src/engine/agent/claude-path.ts（零 vscode 依赖、home注入、Vitest 可测）；命令实现src/adapter/claude-commands.ts复用misc-commands的showOpenDialog/openTextDocument/ 错误处理范式；装配于src/extension.ts。hyperGit.claudeCode.*独立命名空间——Claude Code 是一种具体 CLI 后端，与通用hyperGit.ai.*开关正交。事实性校准
PATH自动探测」以保持事实正确。HEAD。文档同步
新增功能文档
docs/features/claude-code-config.md，登记至文档中心与知识索引；docs/architecture/engineering-plan.md §6、docs/milestones/implementation-status.md §5、docs/research/05-ai-agent-seams.md §阶段1各补 pre-M5 落地注记；CHANGELOG.mdUnreleased 补Added条目。验证
pnpm run check-types+pnpm run lint+pnpm run test:unit全绿（含新增tests/unit/claude-path.test.ts）。🤖 Generated with Claude Code, CodeX, Gemini
Co-Authored-By: Aurelius Huangthreefish.ai@gmail.com