# 在 Claude Code 中使用 DeepCell

装上插件，Claude Code 就能构建把假设、证据和算式一并留在结论背后的模型与备忘录。

Source: https://deepcell.net/product/claude-code.md

## 选 CLI 还是 MCP——只需决定一次

DeepCell 用两种协议连接同一个服务。选哪一种只取决于一件事：你的智能体有没有 shell。

| 你的智能体 | 使用 | 原因 |
| --- | --- | --- |
| Claude Code、Cowork，或你自己的终端 | CLI——即本页 | 有 shell 就能用全部命令：登录、Excel 与 PowerPoint 导出，以及 clone / pull / push / commit / merge 的完整版本历史。 |
| claude.ai、Manus 及其他网页端智能体 | MCP 服务器 | 没有地方运行 CLI。服务器把同样的命令包成一个工具，并屏蔽那些需要浏览器或本地工作副本的命令。 |

一句话：有 shell 用 CLI，没有 shell 用 MCP。要配置 MCP？请看 Connect 页面。

## 1. 安装插件

在 Claude Code 里运行以下命令。安装时会打开一个详情视图供你选择安装范围；reload 让插件在当前会话立即生效。

```bash
/plugin marketplace add deepcell-ai/deepcell-plugins
/plugin install deepcell@deepcell
/reload-plugins
```

之后用这条命令获取新版本：

```bash
/plugin marketplace update deepcell
/plugin update deepcell@deepcell
```

## 2. 安装 CLI

插件调用 deepcell CLI，而不是把它打包进来。一条命令就能装好、放上 PATH 并验证通过——Windows、macOS、Linux 都一样，有没有 pip 都行——对着已有的副本运行也是安全的：最新的保留，过时的升级，不在 PATH 里的放上 PATH。让 Claude 替你运行，或者你自己运行：

macOS / Linux
```bash
curl -LsSf https://deepcell.net/install.sh | sh
```

Windows（PowerShell）
```powershell
irm https://deepcell.net/install.ps1 | iex
```

然后用一条命令检查环境——它会报告版本、服务器是否可达、你是谁，以及当前项目。前面没有登录步骤：在需要账号之前，CLI 以匿名方式就能工作。

```bash
deepcell doctor
```

如果 Claude 的 shell 里 deepcell“找不到”，这还不等于“没装”：副本可能在一个不在 PATH 里的目录，或者沙箱拒绝执行它。安装脚本会把这些情况区分开——它的最后一行 deepcell-install: state=… 是 installed、upgraded、reinstalled、installed-current、installed-unknown、installed-blocked 或 failed 之一——并且绝不重装宿主不肯运行的副本。在 Windows 上，它写入的 PATH 只对新会话生效；当前会话剩下的部分请使用它返回的目录。

已经装过，或者之后想升级：再运行一次安装脚本——普通的重复运行会保留最新的副本，并原地升级过时的副本，用的是当初安装它的那个工具。想先看看有没有可升级的版本，就检查一下——有更新版本发布时 upgrade_available 为 true。DEEPCELL_FORCE=1 是修复路径：即使副本已经是最新的，它也会重装。

```bash
deepcell upgrade check --format json
```

macOS / Linux
```bash
curl -LsSf https://deepcell.net/install.sh | DEEPCELL_FORCE=1 sh
```

Windows（PowerShell）
```powershell
$env:DEEPCELL_FORCE = '1'; irm https://deepcell.net/install.ps1 | iex
```

## 3. 从编排者开始

deepcell 技能是入口。当一个请求需要经得起追问的模型或备忘录时，Claude 会自己调用它；你也可以直接调用：

```bash
/deepcell:deepcell
```

然后说明你要什么——给目标和约束，而不是步骤：

> 用 ./filings 里的财报为 Acme 建一个三年期 DCF。把增长率和利润率假设放在我能改的地方，并记录每个假设为什么是这个值。

它做的第一件事是去看：用 deepcell --help 查命令，用 deepcell guide 读格式与建模。它不会去猜某个参数或标签是否存在。足以独占一份文档的工作会交给 deepcell-builder 智能体，由它从头做到尾并回报结果。

之后同样这样提要求。改一个假设，下游会重算；问某个结论依据什么，答案已经在文件里——因为推理是在工作过程中写下的。

## 插件带来了什么

| 组件 | 名称 | 作用 |
| --- | --- | --- |
| 技能 | deepcell | 入口——与托管版 DeepCell 编排者相同的身份与质量标准：什么算这份工作、什么算做完，以及先去查而不是靠猜。 |
| 智能体 | deepcell-builder | 独立完成一整块工作并回报结果。它拿到的是目标与约束，而不是步骤。 |
| 智能体 | deepcell-model-builder | 构建或修订某份文档的表格面——结构、驱动因子、计算——并验证网格确实填满。 |
| 智能体 | deepcell-deck-author | 在已有模型之上撰写或重排幻灯片面。 |
| 智能体 | deepcell-researcher | 回答需要走出本项目的问题——研究、尽调、方案——并把有来源支撑的发现记入文件。 |
| 智能体 | deepcell-deliverable-reviewer | 判断上游变化之后，各段文字是否仍然成立；只提出修改建议，从不直接改写。 |

插件里不写任何参数名、标签名或函数名，所以重命名不会让它过时。指令层负责身份与判断；deepcell guide 负责格式与建模；deepcell --help 负责命令。技能与各个智能体由托管版智能体所用的同一份提示词生成，一旦落后，漂移测试就会失败。

这个插件目录同时也是一个符合 Agent Plugins Specification v1.0.0 的插件，因此 Claude Code 以外的客户端也能安装同一个技能。Claude Code 只读自己的清单，忽略那份可移植清单；上面那几个智能体是 Claude Code 的概念，不会一起过去。

## 如果没跑起来

- /plugin 列表里没有 DeepCell——先运行 /reload-plugins，再用 /plugin marketplace list 确认 deepcell 市场已添加。
- deepcell: command not found——安装目录不在 PATH 上。重新运行第 2 步里的安装脚本：它会找到那个目录、写进你的 shell 配置文件，并打印出一行可以粘贴到当前 shell 的命令。
- 命令提示你未登录——运行 deepcell login；deepcell doctor 会告诉你 CLI 当前认为你是谁，以及下一步该运行什么。
- Claude 直接改文件里的标记——直接指出来。它的指令是走 CLI，因为那才会触发计算引擎、校验和版本历史。