NGdust/dsh-claude-code-local

dsh-claude-code-local

npm version
license

将你本地安装的 Claude Code 用作 DeepSeek Harness（DSH）中的 LLM 提供方。

该插件注册了一条 claude-code 提供方路由。每次模型请求都会以流式 JSON 模式启动你本地的 claude CLI；Claude Code 运行其自身的智能体循环（其内置工具、权限模式、最大轮数），流式输出的文本会实时转换到 harness 聊天中。

- 在编辑器的模型选择器中选择该提供方 —— 分组 Claude Code (local)。
- DSH 中无需 API 密钥：CLI 使用其自身存储的凭据（~/.claude、ANTHROPIC_API_KEY、OAuth、Bedrock/Vertex 等）。
- 你现有的 Claude Code 配置继续可用：技能、命令、MCP 服务器、权限模式。
- 仅支持 macOS/Linux。

要求

- DeepSeek Harness 0.1.0-rc.7 或更新版本（web、headless 或 DSH Desktop 应用）。
- 已安装并完成认证的 Claude Code CLI：

claude --version

安装

方式 1：DSH Desktop 社区市场

1. 在 DSH Desktop 中打开 Market 页面。
2. Sources → 使用此清单 URL 添加一个源：

https://raw.githubusercontent.com/NGdust/dsh-claude-code-local/main/catalog/manifest.json

3. 选择该源，打开 Discover，找到 Claude Code (local)，然后安装。出现提示时重启应用。

方式 2：dsh CLI

dsh plugin --profile web add dsh-claude-code-local
dsh --profile web

对于 headless 配置，请将 web 替换为配置名称。安装后重启服务器。

方式 3：手动（离线 / 隔离环境）

将此包复制到配置的模块目录中，并在配置补丁层中注册插件行：

cp -R dsh-claude-code-local ~/.dsh/profiles/node_modules/

然后添加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: llm-claude-code
name: dsh-claude-code-local

正在运行的 web 应用无需重启即可识别该行（补丁会被热监听）；DSH Desktop 应用会在下次启动时应用它。

验证

打开编辑器的模型选择器（或 Models 页面），查找带有模型阵容（claude-opus-5、claude-sonnet-5、claude-haiku-4-5、claude-fable-5）的 Claude Code (local) 分组。选择其中任意一个并发送消息 —— 回复将从你本地的 CLI 流式返回。

配置

设置位于 $DSH_HOME/settings.yaml（默认 ~/.dsh/settings.yaml）的 llm-claude-code: 部分，并且会热重载 —— 无需重启：

llm-claude-code:
permissionMode: auto        # auto | acceptEdits | bypassPermissions | manual | dontAsk | plan
maxTurns: 10                # internal agent steps per request
streamIdleTimeoutMs: 300000 # kill the request if the CLI is silent this long (ms)

所有选项
| 键 | 默认值 | 描述 |
| --- | --- | --- |
| executable | claude | Claude Code CLI 的路径或名称。如果 CLI 不在 harness PATH 中，请设置绝对路径（参见 which claude）。 |
| model | "" | 传递给 claude --model 的模型。为空：使用选择器中的选择。default：省略该标志，让 CLI 自行选择。 |
| permissionMode | auto | Claude Code 权限模式。bypassPermissions 是危险的。 |
| allowedTools | [] | claude --allowedTools 列表，例如 ["Bash(git *)", "Read"]。 |
| disallowedTools | [] | claude --disallowedTools 列表。 |
| tools | 未设置 | 原始的 claude --tools 覆盖。""：禁用 Claude 的内置工具（纯文本）。default：恢复它们。 |
| maxTurns | 10 | 每个请求的最大内部代理步数。 |
| appendSystemPrompt | true | 将 harness 系统提示追加到 Claude Code 自身的系统提示之后。 |
| cwd | 未设置 | CLI 的工作目录；未设置则继承 harness 的当前工作目录。 |
| noSessionPersistence | true | 不将 Claude Code 会话文件写入磁盘。 |
| extraArgs | [] | 额外的原始 CLI 参数（高级）。 |
| streamIdleTimeoutMs | 300000 | 流式事件之间的空闲看门狗，以毫秒为单位。 |
| models | 当前阵容 | 在选择器中显示的参考目录（见下文）。 |
| retryPolicy | harness 默认值 | LLM 重试策略。 |

模型目录

models 列表控制选择器提供哪些选项。默认阵容是已安装的 CLI 当前解析出的内容（opus → claude-opus-5，sonnet → claude-sonnet-5，haiku → claude-haiku-4-5，fable → claude-fable-5）。覆盖它以固定或扩展列表：

llm-claude-code:
models:
- id: claude-opus-5
name: Claude Opus 5
contextWindow: 200000
- id: claude-sonnet-5
name: Claude Sonnet 5
contextWindow: 200000
- id: claude-haiku-4-5
name: Claude Haiku 4.5
contextWindow: 200000
- id: claude-fable-5
name: Claude Fable 5
contextWindow: 200000

该列表仅供参考：CLI 决定你的账户实际可以服务哪些模型，而如果选择了不在列表中的模型，它仍然会被服务。

将其设为默认提供方

新会话默认使用配置文件的 agent-default-model（DeepSeek）。要将每个新会话默认使用本地 Claude Code：

agent-default-model:
provider: claude-code
model: claude-sonnet-5

或者直接在编写器的模型选择器中按会话选择提供方。

权限模式

- auto（默认）：Claude Code 的自动模式分类器——安全操作会运行，风险操作在非交互模式下会被拒绝。
- acceptEdits：文件编辑会自动批准。
- bypassPermissions：危险——Claude Code 可以做其工具允许的任何事情（等同于 --dangerously-skip-permissions）。
- manual / dontAsk / plan：参见 Claude Code CLI 文档。

故障排除

| 症状 | 修复方法 |
| --- | --- |
| 模型选择器中未显示提供程序 | 插件未加载。请重新检查安装步骤；重启服务器（DSH Desktop 会在下次启动时应用更改）。 |
| spawn claude ENOENT / claude: command not found | 将 executable 设置为完整路径：llm-claude-code: { executable: /path/to/claude }（参见 which claude）。 |
| 首条消息出现认证 / 账户错误 | 登录一次：以交互方式运行 claude，或检查 ~/.claude / ANTHROPIC_API_KEY。插件从不向 DSH 索要 API 密钥。 |
| 长时间智能体运行在流中途被截断 | 调高 streamIdleTimeoutMs（例如 600000）——当 CLI 静默时间超过超时时间时，请求会被中止。 |
| 文件编辑被阻止 | 使用 permissionMode: acceptEdits。注意：DSH 的沙箱不会限制 Claude Code 的操作——是 CLI 的权限模式在起作用。 |
| 在 Windows 上没有任何反应 | 不支持。请使用 macOS、Linux 或 WSL。 |

工作原理

1. apply() 使用 ClaudeCodeAdapter 注册 claude-code 路由，并在可配置提供程序目录中声明它，这样模型选择器和模型页面就能识别它。
2. 每个请求都会启动 claude -p --output-format stream-json --include-partial-messages --verbose ，并将渲染后的对话通过 stdin 管道传入（长历史记录永远不会触及操作系统参数长度限制）。
3. stream_event/result JSON 事件会被转换为 harness 块：文本增量 → 聊天文本，思考增量 → 推理，工具使用 → 活跃状态行（Claude Code tool: ...），用量 → token 计数。
4. 当调用方中止或空闲超时时，子进程会被终止。

限制

- 每个请求都是一次全新的无状态 CLI 调用；每一轮都会重新渲染完整对话（没有跨请求的提示缓存复用）。
- 此提供程序不使用 harness 自身的工具：Claude Code 拥有自己的循环，因此 DSH 的沙箱/权限服务不会限制 Claude Code 的操作——是 CLI 的 permissionMode 在起作用。
- 来自 harness 请求的 maxTokens / temperature / stop 会被忽略；采样由 CLI 控制。

贡献

发现了 bug 或缺少功能？请在此仓库中提交 issue 或 pull request。

许可证

MIT