dsh-oh-my-claude
Verifieddsh-oh-my-claude · v1.6.2 · MIT · Web UI
Claude Code for dsh (DeepSeek Harness): runs your logged-in Claude Code CLI as a model provider, with live models, session resume, approvals, rewind, memory and remote SSH workspaces
Install
dsh plugin add dsh-oh-my-claude Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
Oh My Claude
English | 中文
在 dsh 里原生使用 Claude Code
把你已登录的 Claude Code CLI 作为 dsh 的一等模型提供方:无需 API key,无需额外服务,没有运行时依赖。
借助 AI 构建,也欢迎更多 AI 参与。欢迎 AI 编程智能体提交贡献,请先阅读 CONTRIBUTING.md。
把 Claude Code CLI 作为 dsh 的 LLM 提供方。每次请求都以 stream-json 输入输出驱动 claude -p,因此沿用 Claude Code 已有的登录、hooks、CLAUDE.md、MCP 服务器和速率限制。无需 API key。插件直接使用 CLI 自己的协议(Agent SDK 封装的就是它),所以没有运行时依赖。
插件界面跟随 dsh 的语言设置(设置 → 通用设置 → 语言)。详细文档目前只有英文版,下方链接均指向英文文档。
功能一览

这个盾牌是 dsh 自带的控件。在 Claude 会话里,它的各项变成 Claude 的六种权限模式,每项都标出它对应的 dsh 访问级别。

输入框旁的一个 ✻ 按钮打开整个插件:记忆、说明、技能、回溯、改动、MCP、旁问、诊断、任务和调校;会话还是空白时另有一个恢复标签。


费用和缓存 token 数是 dsh 自己算不出的两个数字,它们出现在 dsh 底部的统计行里。会话花费超过你设定的额度后,这个标签会变成橙色。金额按 API 价格计算;使用 Claude 订阅时不会向你收取这笔钱。

套餐用量和 CLI 自己的上下文明细显示在 dsh 的上下文圆环弹窗里。在手机上,面板变成底部弹层。

保存一台 SSH 主机后,dsh 自带的添加工作区对话框会多出一个主机下拉框:那台主机上的文件夹可以成为这里的工作区,其中的会话在那台主机上运行 Claude Code。
截图由 tools/playwright/tour.ts 生成。
安装
需要 Claude Code CLI 在 PATH 上并已登录(claude --version 能运行,打开 claude 不会要求登录),以及 dsh 0.2(0.2.2-alpha.2 或更新版本)。dsh 0.2.0 或 0.2.1 请安装 1.5.14([email protected]);dsh 0.1.x 请按下方兼容性表格安装对应的 npm 标签。别的都不需要:没有 API key,没有 Node 构建步骤。
通过 dsh 的插件页面,在 Web 应用或 DSH Desktop 中:
- 在侧边栏打开 插件,点击 添加插件。
- 输入
dsh-oh-my-claude,点击 安装。 - 点击 立即启用,或稍后在 已安装插件 里打开它的开关。
无需重启就会加载。刷新页面后,模型选择器里会出现 "Oh My Claude",列出你的登录可用的模型。选一个就能开始对话。
通过终端,然后用你自己的方式重启 dsh:
dsh plugin --profile web add dsh-oh-my-claude
systemctl --user restart dsh-web.service
想直接从仓库而不是 npm 安装,在两种方式里都把包名换成 github:lcestou/dsh-oh-my-claude。
如果选择器里显示 Oh My Claude (未登录),请在运行 dsh 的机器上打开终端运行 claude auth login,或在 设置 → Oh My Claude → 主机 中点击登录。
DSH Desktop(macOS 和 Windows)按上面插件页面的步骤安装。从 Dock 启动的应用看不到你 shell 的 PATH,所以插件会在常见的安装目录里查找 claude。在 Windows 上,插件把 Claude 作为 dsh 的普通子进程运行,因此重启应用会中断正在进行的回合,需要 Unix shell 的功能(在设置里登录、SSH 主机)也不可用。服务端已按 Desktop 的方式在 Linux 上用 Electron 运行过,也在 Windows 11 上配合 npm 安装的 Claude Code 运行过。
npm 上有新版本时,设置和面板的运行环境行会出现一个带版本号的橙色标签。点击它会在 dsh 的插件页面中打开 Oh My Claude,用 dsh 自己的更新按钮安装;标签旁的复制按钮会复制在终端里用的更新命令。DSH Desktop 也会显示这个标签,但没有复制按钮,因为它的命令行没有可复制的命令。详情以及插件在 dsh 升级后自行完成的修复,见 Plugin updates。
可选,在 ~/.dsh/settings.yaml 中:
agent-default-model: # 让新会话默认使用 Claude Code
provider: claude-code
model: claude-fable-5-1 # 模型选择器中列出的任一模型 id
subagent-model-selection: # 让 dsh 子智能体也能使用 Claude Code
enabled: true
allowedModels:
- provider: claude-code
model: claude-haiku-5-5 # 模型选择器中列出的任一模型 id
想参与开发插件本身?从 docs/developing.md 开始。
兼容性
dsh 只发布预发行版,客户端 API 也会在版本之间变动,所以插件的每个版本都记录它面向的 dsh 范围和实际运行验证过的 dsh。"可运行于"是代码带有兼容分支的范围;"测试于"是发版时机器上安装的那个 dsh。更新提示会从 npm 读取最低 dsh 版本:低于它的机器不会收到更新命令,提示会改为写明该版本需要的 dsh。
| 插件 | 可运行于 dsh | 测试于 dsh | npm 标签 |
|---|---|---|---|
| 1.6.2 | 0.2.2-alpha.2 至 0.2.2-rc.1 | 0.2.2-rc.1 | latest |
| 1.6.1 | 0.2.2-alpha.2 至 0.2.2-rc.1 | 0.2.2-rc.1 | 无,已由 1.6.2 取代 |
| 1.6.0 | 0.2.2-alpha.2 至 0.2.2-rc.1 | 0.2.2-rc.1 | 无,已由 1.6.1 取代 |
| 1.5.14 | 0.2.0-rc.1 至 0.2.2-rc.1 | 0.2.2-rc.1 | dsh-0.2.1、dsh-0.2 |
| 1.5.13 | 0.2.0-rc.1 至 0.2.2-rc.1 | 0.2.2-rc.1 | 无,已由 1.5.14 取代 |
| 1.5.12 | 0.2.0-rc.1 至 0.2.2-alpha.2 | 0.2.2-alpha.2 | 无,已由 1.5.13 取代 |
| 1.5.11 | 0.2.0-rc.1 至 0.2.2-alpha.2 | 0.2.2-alpha.2 | 无,已由 1.5.12 取代 |
| 1.5.10 | 0.2.0-rc.1 至 0.2.2-alpha.2 | 0.2.2-alpha.2 | 无,已由 1.5.11 取代 |
| 1.5.9 | 0.2.0-rc.1 至 0.2.1-rc.4 | 0.2.1-rc.4 | 无,已由 1.5.10 取代 |
| 1.5.8 | 0.2.0-rc.1 至 0.2.1-rc.4 | 0.2.1-rc.4 | 无,已由 1.5.9 取代 |
| 1.5.7 | 0.2.0-rc.1 至 0.2.1-rc.3 | 0.2.1-rc.3 | 无,已由 1.5.8 取代 |
| 1.5.6 | 0.2.0-rc.1 至 0.2.1-rc.3 | 0.2.1-rc.3 | 无,已由 1.5.7 取代 |
| 1.5.5 | 0.2.0-rc.1 至 0.2.1-rc.2 | 0.2.1-rc.2 | 无,已由 1.5.6 取代 |
| 1.5.4 | 0.2.0-rc.1 至 0.2.1-rc.2 | 0.2.1-rc.2 | 无,已由 1.5.5 取代 |
| 1.5.3 | 0.2.0-rc.1 至 0.2.1-alpha.1 | 0.2.1-alpha.1 | 无,已由 1.5.4 取代 |
| 1.5.2 | 0.2.0-rc.1 至 0.2.0-rc.2 | 0.2.0-rc.2 | 无,已由 1.5.3 取代 |
| 1.4.2 | 0.1.5-rc.1 至 0.1.7-rc.2 | 0.1.7-rc.2 | dsh-0.1.7 |
| 1.4.1 | 0.1.5-rc.1 至 0.1.7-rc.2 | 0.1.7-rc.2 | 无,已由 1.4.2 取代 |
| 1.4.0 | 0.1.5-rc.1 至 0.1.7-rc.2 | 0.1.7-rc.2 | 无,已由 1.4.1 取代 |
| 1.3.1 | 0.1.5-rc.1 至 0.1.6-alpha.2 | 0.1.6-alpha.2 | dsh-0.1.6 |
| 1.2.1 | 0.1.5-rc.1 至 0.1.6-alpha.2 | 0.1.6-alpha.2 | dsh-0.1.5 |
你能得到什么
- 在 dsh 自己的选择器里使用你的登录可用的任何 Claude 模型。用设置里的开关或插件配置的
hiddenModels隐藏不用的模型。在同一处设置里或用customModels添加列表里没有的模型,例如本地路由转发到其他模型的名称。菜单会跟随路由:打开 CC Switch 这类路由后列出路由提供的模型,关闭后恢复为 Claude 的模型,无需刷新。Models - 每个 dsh 会话都会续接它的 Claude Code 会话(包括工具历史),终端里的
claude /resume看到的是同一个会话。Sessions - 重启 dsh 不会中断正在运行的 Claude 回合。Restarts
- dsh 的访问权限盾牌按会话设置 Claude 的六种权限模式。Permission mode
- Claude 的权限请求、提问和计划审阅都变成 dsh 对话框,每个选项的预览显示在问题下方。Approvals
- 一个 ✻ 按钮打开记忆、回溯、改动、MCP 等十余个标签,全部可以用键盘操作。The panel
- 费用和缓存 token 显示在 dsh 底部,超过设定额度时标签变橙。Cost pill
- 套餐用量(5 小时、每周、额外用量)显示在 dsh 的上下文圆环里,接近上限时变琥珀色,达到上限时变红,并在输入框上方提示。只统计会话所用模型计入的额度,由 Anthropic 判定,所以新模型无需更新插件。Plan usage
- 恢复或导入任何过去的 Claude 记录,无论来自 dsh 还是终端,并可在其中搜索说过的内容。Session browser
- Claude 的斜杠命令和技能以原名出现在 dsh 的斜杠菜单里,dsh 已占用的名字改为
/claude-<name>。dsh 自己也提供的技能在任何模型上都能运行;只有 Claude Code 才有的技能也一样:在其他模型的会话中输入时,会连同其指令一起交给该模型(可在设置中关闭)。Command bridge - Claude 可以通过 MCP 使用 dsh 的子智能体、后台任务、目标和网页搜索。它还能新开一个 dsh 会话,向它发送后续消息并读取回复(
open_session、prompt_session、wait_session)。dsh tools over MCP - 在面板里编辑本机或远程主机上的 CLAUDE.md、settings.json 和 MCP 服务器,并登录需要登录的 MCP 服务器。Instructions、settings.json editor、MCP
- 通过 SSH 在另一台主机上运行 Claude,或挂载多个账号。Remote boxes and accounts
- 用一份已脱敏的本机报告反馈问题,可复制,也可直接提交 issue。Report a problem
- 所有橙色都可以按组关闭,颜色也可以自选。Claude look
- 选择 dsh 往你的提示词里添加哪些内容,每一块的大小都标在标签上。dsh context
- 会话所在主机有新的 Claude Code 版本时会出现卡片,并可在 dsh 里直接安装;无界面的
claude -p从不自动更新。每台主机的更新渠道、自动安装和历史记录都在设置里的开关下。Claude Code updates - 在设置里查看最近五个版本的变化,内容来自插件自己的更新日志。Changelog
- 按范围列出 CLI 能用到的所有技能,你自己的和项目的技能可以添加、编辑和删除。每个技能的开销来自 CLI 自己的
/skill-doctor,是一张可排序的表格,旁边还有其他影响用量的因素:请求最多的 MCP 服务器,以及工作的构成。Skills - 你没在看的会话完成或停下来问你时,浏览器标签页会有标记,还可以选择弹出桌面通知。Session notices
- dsh 自己的目标和会话以往的每个目标,与 Claude Code 的目标和定时任务并列显示。Tasks
- Claude 工作时你插话发送的消息,在 Claude 读取之前可以编辑或移除,也可以合并为一条编辑。消息上的文件或图片会保留,只修改文字。编辑期间消息不会发出。“立即发送”会打断 Claude,把这条消息作为下一轮发出。Steering
- 向上滚动越过 Claude 的工作状态行(旋转图标、动词、数字)后,它会在输入框上方重复显示,回看一长轮时也不会错过 Claude 正在做的事。设置中有开关可关闭。轮次状态
- 在回复中选中文本,dsh 的浮层(dsh 0.2.2)会在「引用文本」旁多一个「提问」,手机上则显示在输入框上方的一行:把这段内容作为旁问向 Claude 提问,不占用对话本身;问题留空,Claude 会解释这段内容。旁问
- 一轮结束后,标题处保留一行收尾,和终端里一样:
✻ 烘焙了 27s · 03:21 完成。被你停止的一轮显示已中断 · 想让 Claude 改做什么?。轮次状态 - Claude 的工具调用显示为 dsh 自己的工具卡片,和其他提供方一样,文字在卡片之间实时输出。也可以在设置中切换回行内文本(「原生工具卡片」)。Native tool rows
- 在工作区中新建会话时,会使用该工作区上次运行的 Claude 主机、模型和推理强度;没有记录的工作区则使用你选定的默认模型和推理强度。按工作区记住模型
- 每次回复后,Claude 对你下一条提示的猜测显示在输入框上方:「采用」填入输入框,「发送」原样发出,你输入别的内容时它会自动收起。默认开启,与终端一致;设置中有开关可关闭。下一条提示建议
- Claude 的后台 shell 任务和子智能体运行时列在任务标签里,每项都有「停止」,shell 任务还有「输出」;运行中的有两个以上时还有「全部停止」。已结束的 shell 任务保留其行和「输出」,最多十条;会话已运行过的子智能体列在「之前的子智能体」下,每个都能以 Markdown 打开。聊天中子智能体的那一行会按 CLI 的报告逐步列出它在做什么。任务
- 如果 dsh 环境里的
ANTHROPIC_API_KEY取代了你的登录成为 Claude Code 的计费来源,会话开始时会用一行说明。Where things live - 每个额度窗口会按当前速度给出走向:窗口结束时用到的百分比,或达到上限的时间。Plan usage
- 上下文窗口用到 75%(可在设置中调整)时,输入框上方会提醒并提供「压缩」按钮,发送 Claude 自己的
/compact。Context nudge - Claude 写的每段 shell 代码块都有「运行」按钮,把代码作为提示放入输入框,按 Enter 发送后经由 Claude 的 Bash 工具和 dsh 的审批执行。Run a snippet
- 在 dsh 里重命名的会话在
claude --resume中沿用同名,Claude 一侧设置的名字也会重命名 dsh 会话。Command bridge - 在 Claude 和其他模型(例如 DeepSeek 或本地模型)之间来回切换同一个会话:Claude 能看到其他模型期间的提示、回复和工具调用。Sessions
- 输入框为空时按上箭头调出上一条提示词,再按上箭头调出更早的,下箭头调出更新的直至清空,与 Claude Code 终端一致;输入任意字符即结束回溯。新会话从该工作区最近的记录中回溯。可在设置中关闭(「提示词回溯」)。
- 在输入框按 Ctrl+R 搜索之前输入过的提示词:范围可为本会话、本工作区或整台机器(Ctrl+S 或 Ctrl+↑/↓ 切换)。Enter 发送所选行,Tab 填入输入框,Esc 关闭。可在设置中关闭(「历史搜索」)。
- 输入框为空且没有任务运行时按两次 Esc,打开回溯标签页并选中最新一条提示词,与终端按两次 Esc 打开 /rewind 一致;回溯后该提示词会回到输入框,可修改后重新发送。可在设置中关闭(「编辑上一条提示词」)。这三个输入框按键也列在 dsh 的快捷键对话框里。
- 插件自带三个命令:
/btw <问题>向 Claude 提一个旁问,不加入对话;/temporary让该会话不保留 Claude 的对话记录;/ultracode开关 Claude Code 的 ultracode,无需重启进程。Asides、Temporary sessions、Ultracode
一些你永远不必动的默认行为,比如工具结果中的密钥脱敏和挺过 CLI 自身的更新,见 How it works。
配置
设置分两类。设置 → Oh My Claude 下和面板调校标签里的开关会立即保存在本机,所以每个浏览器看到的都一样。调校标签里的项在 Claude 进程下次启动时生效。下面这些键在安装时配置:写在 profile 的 cordis.patch.yml 中该 bundle 行的 config: 下,dsh 下次加载插件时生效,重启 dsh 即可。dsh 自己的插件页面会列出这个插件并提供开关,但没有这些键的表单。最常改的三个键:
permissionMode: dsh # 跟随会话的盾牌(默认),或固定为 CLI 的六种模式之一
# spawn: node # 不设置:由下方的设置开关决定;设为 node 或 dsh 则以此为准
sshHost: "" # "[user@]host" 通过 ssh 驱动另一台机器上的 claude
每个键及其默认值见 docs/configuration.md。
dsh 重启时保持 Claude 运行
设置 → Oh My Claude 下的这个开关决定 Claude Code 的启动方式,默认开启。配置中的 spawn: node 或 spawn: dsh 会覆盖它并锁定开关;spawn: keeper 不会锁定。切换后,每个会话在下一个回合生效。
开启(keeper) |
关闭(dsh) |
node(仅限配置) |
|
|---|---|---|---|
| dsh 重启时正在进行的回合 | 继续运行;新的 dsh 重新接上并显示它做了什么 | 结束;重启约十秒后,会话会收到一条“dsh 在此回合进行中重启”的提示并继续 | 同关闭 |
| dsh 退出后仍在运行的进程 | Claude,直到它在没有 dsh 连接且没有输出的情况下经过 processIdleMs(30 分钟,最少 5 分钟) |
正常退出后没有:dsh 会结束 Claude 及它启动的一切 | dsh 结束时 Claude 也结束;它启动的进程不受追踪 |
| dsh 的环境变量 | 全部传递 | 除 DSH_* 外全部传递:dsh 的 subprocess 接口会过滤含 KEY、TOKEN、SECRET、PASSWORD 的变量名,插件会把它们传回 |
全部传递 |
| SSH 主机和远程工作区 | 远端的 claude 托管在该主机上,同样不受重启影响;上面的空闲时限对它无效,它会一直运行,直到有 dsh 重新接上或主机重启 |
远端的 claude 随 ssh 连接一起结束 |
同关闭 |
| 平台 | Linux 和 macOS;Windows 上为 node |
全部;dsh 未挂载 subprocess 接口时为 node |
全部 |
DSH Web 和 DSH Desktop 使用各自的 dsh profile,因此只会重新接上各自启动的 Claude 进程。在同一个 profile 目录上启动的两个 dsh 仍会共用它们。
远程主机和账号
用不同的 configDir 把插件挂载两次,即可使用两个登录。在 设置 → Oh My Claude → 主机 中列出其他运行 dsh 和本插件的主机,并在它们之间切换。也可以给一台主机起个名字、填上 user@host,通过 SSH 驱动那里的 claude,远端只需要安装 CLI;Tailscale 和 WireGuard 对等节点会作为可选主机出现。详见 docs/remote.md。
它会接触什么
- 运行 你已有的
claude程序,在本机或你通过 SSH 添加的主机上。 - 读取 Claude Code 的登录信息(
~/.claude/.credentials.json;macOS 上该文件没有有效令牌时读钥匙串里的Claude Code-credentials;或已设置的ANTHROPIC_API_KEY),用来获取模型列表和套餐用量。这个令牌只会发往api.anthropic.com。 - 写入 自己的状态到
~/.local/state/dsh-oh-my-claude/;SSH 主机的登录令牌保存为只有你能读取的文件。CLAUDE.md、settings.json 和 MCP 服务器只在你从面板编辑时才会改动。 - 监听 一个 Unix socket,供在 dsh 重启期间托管 Claude 的 keeper 使用。插件的 HTTP 路由都在 dsh 自己的服务器里,所以在 DSH Web 下不开放 TCP 端口。在 DSH Desktop 下,其 Web 服务器对非自身窗口的请求一律返回 403,因此把 dsh 工具交给 Claude 的桥接会另在 127.0.0.1 上监听,仍由同一把密钥保护。
- 访问
api.anthropic.com(模型、套餐用量)、status.anthropic.com、downloads.claude.ai(CLI 的版本指针)、registry.npmjs.org(插件更新检查)和api.github.com(仓库的 Star 数)。SSH 只连接你添加的主机。
不包含的内容
- dsh 的 shell 和文件工具不经过代理(后台任务用的
bash除外);Claude Code 使用自己的工具,受它自己的权限模式约束。 - 删除 dsh 会话时不会删除对应的 Claude Code 会话。
问题与反馈
发现 bug,或有读起来不对的地方?请在 github.com/lcestou/dsh-oh-my-claude/issues 提交 issue,附上 dsh 和 Claude Code 的版本(dsh --version、claude --version)以及你期望看到的结果。设置 → Oh My Claude → 报告问题 会替你写好这份报告。
许可证
MIT。
Claude、Claude Code 和 Claude spark 标志是 Anthropic, PBC 的商标。本项目是一个独立的 dsh 插件,驱动你已有的 Claude Code CLI;它并非由 Anthropic 制作、认可或支持。这里画出 spark 只是为了标明哪些会话和控件属于 Claude Code,方式与 CLI 自身的画法一致。