manual

Claude Code Local (Project)

Scope Neptrix governance to a single project by hand. The desktop app’s Setup page connects Claude Code globally (every project on the machine); to govern just one project instead, place the hook configuration in that project’s .claude/settings.json yourself. No API key.

需要 Neptrix 桌面应用

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

安装

1Download and install the Neptrix desktop app for macOS or Windows from the download page, and complete its Setup page so the local runtime and bridge daemon are installed and running. (If you use Connect there, Claude Code is governed globally and this project is already covered.)
2For project-only scope, create or open .claude/settings.json in the project root and paste the configuration shown below.
3Restart Claude Code so it loads the hook. Tool calls in this project 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。

下载测试版