desktop app

Claude Code Local (Global)

Connect every Claude Code session on your machine to the Neptrix local runtime. Install the desktop app, then use its Setup page; the app writes the hook 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 use the Setup page to connect Claude Code. The app writes an equivalent, hardened version of the hook configuration shown below into ~/.claude/settings.json (a fail-closed guard plus capture hooks) and manages the runtime for you. The configuration shown is the documented manual route.
3Restart Claude Code so it loads the hook. Tool calls across all projects are now governed by the local runtime: the beta enforces from the first connect, on the Default tier until you change it in the desktop app. The hook fails closed if the runtime is not running.
4Inspect the tamper-evident 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": "sh -c 'if [ -f \"$HOME/.neptrix/bin/client.js\" ]; then exec node \"$HOME/.neptrix/bin/client.js\"; else exit 0; fi'",
13            "timeout": 105
14          }
15        ]
16      }
17    ]
18  }
19}

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

工作原理

智能体提议操作

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

Neptrix 进行评估

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

返回决策

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

获取桌面测试版。

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

下载测试版