# additionalContext

> A hook field that adds a note for Claude to read.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** hookSpecificOutput.additionalContext

## Think of it like

It is like a sticky note in a book. The next reader finds it.

## Definition

additionalContext is a field in a hook's JSON output that adds text to Claude's context. Claude Code wraps it as a system reminder at the point the hook fired. Claude reads it on its next request, but it is not shown as a chat message. Each value is capped at 10,000 characters, and a longer one is saved to a file.

## Example

Claude kept editing a generated file. Emma's hook adds a note each time, and Claude edits the source file instead.

## Example code

```json
{
  "hookSpecificOutput": {
    "hookEventName": "PostToolUse",
    "additionalContext": "This file is generated. Edit src/schema.ts and run npm run gen instead."
  }
}
```

Tell Claude a file is generated.

## Why it matters

It gives Claude the right fact at the right moment, not in a long file it read an hour ago.

## Common mistake

Putting must-see text past the cap. Claude gets a file path and a preview, and may not open the file.

## Three principles

- **Text for Claude.** Not a chat line.
- **At the moment it fires.** As a reminder.
- **Capped.** 10,000 characters.

## Related terms

- [Hook JSON Output](https://learn.benibix.com/term/ai/hook-json-output)
- [UserPromptSubmit Hook](https://learn.benibix.com/term/ai/userpromptsubmit-hook)
- [PostToolUse Hook](https://learn.benibix.com/term/ai/posttooluse-hook)

---

Source: https://learn.benibix.com/term/ai/hook-additional-context
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
