CLAUDE_CODE_SCRIPT_CAPS
Updated by Alex Sorokoletov
CLAUDE_CODE_SCRIPT_CAPS is a Claude Code environment variable: Limits per-session script invocations. The changelog[1] pairs this with subprocess sandboxing via PID namespace isolation on Linux (when CLAUDE_CODE_SUBPROCESS_ENV_SCRUB is set). Added between v2.1.96 and v2.1.100 and still present in v2.1.294. It is listed in the official reference.
| Status | Present in v2.1.294 |
|---|---|
| Added | Added between v2.1.96 and v2.1.100 |
| Category | Other |
| Official docs | Listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_SCRIPT_CAPS=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_SCRIPT_CAPS": "<value>"
}
}Release notes that mention it
- Claude Code v2.1.100 — 3 New Environment Variables: Context Token Limits, Perforce VCS, and Script Capability Controls
- Claude Code Version Tracker: Undocumented Env Vars, Feature Gates & Models
Related variables
CLAUDE_SCRIPT_HOOK_ACKANTHROPIC_BETAS: Comma-separated beta feature headers.ANTHROPIC_CUSTOM_HEADERS: Custom HTTP headers (newline-separated Key: Value).ANTHROPIC_FEDERATION_RULE_IDANTHROPIC_ORGANIZATION_IDANTHROPIC_WORKSPACE_IDBETA_TRACING_ENDPOINT: Custom endpoint for beta tracing.CLAUDE_AFK_COUNTDOWN_MS
Frequently asked questions
What does CLAUDE_CODE_SCRIPT_CAPS do?
Limits per-session script invocations. The changelog[1] pairs this with subprocess sandboxing via PID namespace isolation on Linux (when CLAUDE_CODE_SUBPROCESS_ENV_SCRUB is set).
Which Claude Code version has CLAUDE_CODE_SCRIPT_CAPS?
Added between v2.1.96 and v2.1.100 and still present in v2.1.294.
How do I set CLAUDE_CODE_SCRIPT_CAPS?
Export it before starting Claude Code (export CLAUDE_CODE_SCRIPT_CAPS=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.