dsh-claude-pilot
Drive the local Claude Code CLI from DSH: claude_run / claude_resume / claude_probe with session continuity, plus the standalone loopback bridge (HTTP + file mailbox).
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Dobo233/dsh-claude-pilotREADME
Read the full README ↗配置
claudePath: null # 显式路径;null = 自动探测(node 同目录的 node_modules/@anthropic-ai/claude-code/bin/claude.exe → %APPDATA%\npm\... → ~/.local/bin/claude → PATH)
defaultCwd: null # 默认工作目录
timeoutMs: 600000
maxOutputChars: 20000 # 超长保留尾部
permissionMode: null # null = 用 Claude Code 自己的设置;可选 default / acceptEdits / plan / bypassPermissions
extraEnv: {}
无头登录(CI / 桥 / 不开终端界面)
Claude Code 的登录态不跟桌面端共享:CLI 自己的凭据只在 ~/.claude.json 的 claudeAiOauth 字段或 ~/.claude/.credentials.json 里,两者都没有时 -p 会直接返回 Not logged in · Please run /login。
两种补法:
claude # 交互式一次,进来后 /login(浏览器 OAuth,选同一个账号)
claude setup-token # help 原文:"Set up a long-lived authentication token (requires Claude subscription)"
setup-token 拿到的是长期 token,放进环境变量即可被本插件继承(env 是 process.env 直通):
$env:CLAUDE_CODE_OAUTH_TOKEN = '' # 当前会话生效
# 或只给插件:配置里 extraEnv: { CLAUDE_CODE_OAUTH_TOKEN: '' }
独立桥(不用 DSH)
node standalone/bridge.cjs # 默认 http://127.0.0.1:8788
- HTTP:
GET /health、GET /probe、POST /run、POST /resume(别名POST /claude、POST /start);没有/queue - 文件信箱:
mailbox/inbox/.json→mailbox/results/.json - Windows 最短路径:
.\standalone\ask.ps1 "任务描述"(桥没起来会自动拉起)
请求体:{ prompt, cwd?, model?, permissionMode?, jsonSchema?, timeoutMs?, sessionId?, last?, fork? }。
排错
| 现象 | 原因 | 处置 |
|---|---|---|
result: "Not logged in · Please run /login",exit=1 | 这台机器的 Claude Code 没登录(本插件转发的是 CLI 的登录态) | 终端跑一次 claude 完成 /login,再用 claude_probe 确认 |
claude_probe 报 --resume: no | Claude Code 版本太老 | 升级 @anthropic-ai/claude-code |
spawn 失败 EINVAL | 指向了 claude.cmd(Windows 上 .cmd 不能被 Node 直接 spawn) | 让 claudePath 指向 ...\claude-code\bin\claude.exe,插件只对 .cmd 才走 cmd.exe 转发 |
安全边界
- 只跑本机已登录的 Claude Code,不读取、不转发、不存储任何凭据。
- Claude Code 默认会问权限;想无人工跑完要么在设置里放行,要么显式传
permissionMode: "bypassPermissions"(自己承担风险)。 - 桥只绑
127.0.0.1,没有鉴权:不要暴露到公网。
兼容性
- DSH
0.2.x;Node^22.19.0 || >=24.0.0 - Claude Code
2.1.187实测(-p / --output-format / --resume / --continue / --json-schema全在)
English
dsh-claude-pilot exposes the local Claude Code CLI as DSH tools (claude_run, claude_resume, claude_probe) with session continuity via session_id → --resume, plus a standalone loopback bridge. It wraps your already-authenticated claude binary — no credential handling. Claude Code has no way to inject a message into a running session, so there is no queue counterpart; instead it exposes --json-schema structured output. Loopback only, no auth.
License
MIT