Dobo233/dsh-claude-pilot ↗★ 0

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).

パッケージ
dsh-claude-pilot
互換性
未検証
Harness ピア範囲
>=0.1.5-rc.1 <0.2.0-0 || >=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-rc.1 <0.3.0
バージョン
0.1.0
ライセンス
MIT
最終更新
2026/10/26

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Dobo233/dsh-claude-pilot

ドキュメント

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: noClaude 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