> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/llms.txt. # Use the Guardrails Hooks Server > Check the tool calls of Claude Code, Codex, and NeMo Relay before they run, with the Guardrails hooks server. The NVIDIA NeMo Guardrails library includes the Guardrails hooks server (`nemoguardrails hooks-server`), which checks a coding agent's tool calls before the agent runs them. The agent's own pre-tool hook sends each call to the hooks server, which applies a tool policy and tool-call rails to it and answers with allow or deny. The hooks server is a separate process from the [Guardrails API server](/run-guardrailed-inference/using-fastapi-server) (`nemoguardrails server`). It serves only the agent hook endpoints, and it never calls a model to generate a response. #### [Overview](/run-guardrailed-inference/using-hooks-server/overview) How the hooks server checks a tool call, how it differs from the Guardrails API server, and a quick start. Concept #### [Run the Hooks Server](/run-guardrailed-inference/using-hooks-server/run-hooks-server) Start the server, write its tool policy and rails, and monitor it with logs, metrics, and traces. Tutorial #### [Claude Code](/run-guardrailed-inference/using-hooks-server/claude-code) Send every Claude Code tool call to the hooks server with an HTTP hook. How To #### [Codex](/run-guardrailed-inference/using-hooks-server/codex) Send every Codex tool call to the hooks server with a command hook. How To #### [NeMo Relay Plugin](/run-guardrailed-inference/using-hooks-server/nemo-relay-plugin) Check every tool call NeMo Relay manages with the NVIDIA NeMo Guardrails Plugin. How To #### [NeMo Relay Endpoint](/run-guardrailed-inference/using-hooks-server/nemo-relay) The endpoint a NeMo Relay plugin's tool guardrail calls. Reference #### [Results and Errors](/run-guardrailed-inference/using-hooks-server/results-and-errors) What each agent path returns for an allow, a deny, and an error, and how to make an agent block a call when a check fails. Reference #### [Hooks Server API](/reference/hooks-server-api/overview) The request and response fields of each hooks server endpoint. Reference ## Docs - [Overview of the Guardrails Hooks Server](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/overview.md): The Guardrails hooks server checks a coding agent's tool calls before they run, from the agent's own pre-tool hook. - [Run the Hooks Server](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/run-hooks-server.md): Start the Guardrails hooks server, write its tool policy and per-tool rails, and monitor it with logs, metrics, and traces. - [Check Claude Code Tool Calls with the Hooks Server](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/claude-code.md): Connect Claude Code to the Guardrails hooks server with an HTTP PreToolUse hook, so every tool call is checked before it runs. - [Check Codex Tool Calls with the Hooks Server](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/codex.md): Connect Codex to the Guardrails hooks server with a PreToolUse command hook, so every tool call is checked before it runs. - [Check NeMo Relay Tool Calls with the NVIDIA NeMo Guardrails Plugin](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/nemo-relay-plugin.md): Build, install, and configure the NVIDIA NeMo Guardrails Plugin for NeMo Relay to check tool calls before they run. - [Check NeMo Relay Tool Calls with the Hooks Server](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/nemo-relay.md): The /v1/hooks/nemo-relay endpoint of the Guardrails hooks server, for a NeMo Relay plugin's tool conditional-execution guardrail. - [Hooks Server Results and Errors](https://docs.nvidia.com/nemo/guardrails/latest/run-guardrailed-inference/using-hooks-server/results-and-errors.md): The allow, deny, and error outcomes of the Guardrails hooks server, its deny reasons and error responses, and how to make each agent block a call when a check fails.