desktop app

Claude Code Local (Project)

Connect this project’s Claude Code to the Neptrix local runtime. Install the desktop app, then use its Setup page; the app writes the hook configuration and manages the runtime. No API key.

需要 Neptrix 桌面应用

此设置使用 Neptrix 桌面应用，该应用会安装并管理本地运行时。下载 macOS 或 Windows 测试版。

安装

1Download and install the Neptrix desktop app for macOS or Windows from the download page.
2Open the app and follow the Setup page to connect Claude Code for this project. The app writes the hook configuration shown below into .claude/settings.json and manages the runtime for you.
3Restart Claude Code so it loads the hook. Tool calls in this project are now evaluated and recorded by the local runtime; this beta runs in monitoring mode, so nothing is blocked. The hook fails closed if the runtime is not running.
4Inspect the signed audit chain any time with: neptrix-runtime view --config ~/.neptrix/runtime.json --verify

高级：手动钩子配置

桌面应用的 Setup 页面会为您写入此配置。仅当您希望手动接入钩子时才使用手动方式。

将此配置添加到.claude/settings.json

.claude/settings.json

1{
2  "env": {
3    "NEPTRIX_BRIDGE_DAEMON_SOCKET": "$HOME/.neptrix/bridge-daemon.sock"
4  },
5  "hooks": {
6    "PreToolUse": [
7      {
8        "matcher": ".*",
9        "hooks": [
10          {
11            "type": "command",
12            "command": "node $HOME/.neptrix/bin/client.js",
13            "timeout": 105
14          }
15        ]
16      }
17    ]
18  }
19}

无需 API 密钥。桌面应用管理本地运行时，钩子通过套接字与其通信。下载桌面测试版。

工作原理

智能体提议操作

在每次工具调用之前，您的智能体将提议的操作发送给 Neptrix 进行评估。

Neptrix 进行评估

宪法治理规则评估操作。决策被记录到您的审计追踪中。

返回决策

ALLOW、BLOCK、ESCALATE 或 MODIFY。智能体自动发现——无需注册。

获取桌面测试版。

下载适用于 macOS 或 Windows 的 Neptrix 桌面应用，并在 Setup 页面连接 Claude Code。

下载测试版