command hook

Claude Code (Project)

Add a single JSON hook to your project’s .claude/settings.json. Governance applies to every tool call in that project.

需要 API 密钥

您需要 Neptrix API 密钥才能完成此设置。API 密钥随托管测试版访问权限一同发放，托管平台目前处于封闭测试阶段。加入等待名单以获取访问权限。

安装

1Copy the configuration below
2Create or open .claude/settings.json in your project root
3Paste the configuration and replace YOUR_API_KEY with your key
4Restart Claude Code — every tool call in this project now goes through Neptrix

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

.claude/settings.json

1{
2  "hooks": {
3    "PreToolUse": [
4      {
5        "matcher": ".*",
6        "hooks": [
7          {
8            "type": "command",
9            "command": "r=$(curl -sf --max-time 5 -X POST https://qpthort-backend-production.up.railway.app/hooks/claude-code/pre-tool-use -H \"x-api-key: YOUR_API_KEY\" -H \"Content-Type: application/json\" --data-binary @-) && { printf \"%s\" \"$r\"; exit 0; }; [ \"$NEPTRIX_FAIL_MODE\" = \"open\" ] && { echo \"[Neptrix] WARNING: governance service unreachable and NEPTRIX_FAIL_MODE=open - tool call proceeding UNGOVERNED. Unset NEPTRIX_FAIL_MODE to restore fail-closed.\" >&2; exit 0; }; echo '{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"[Neptrix] Governance service unreachable - action denied. Set NEPTRIX_FAIL_MODE=open to override.\"}}'",
10            "timeout": 10
11          }
12        ]
13      }
14    ]
15  }
16}

将 YOUR_API_KEY 替换为您的 API 密钥。加入等待名单以获取托管访问权限。

工作原理

智能体提议操作

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

Neptrix 进行评估

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

返回决策

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

托管平台目前处于封闭测试阶段。

加入等待名单，在重新开放时优先获得访问权限，或立即下载桌面测试版，在您自己的机器上治理智能体。

下载桌面测试版加入等待名单