claude-code - 💡(How to fix) Fix [DOCS] Documentation on Permissions and Wrapper Commands [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#46333Fetched 2026-04-11 06:23:03
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
Participants
Timeline (top)
labeled ×5
RAW_BUFFERClick to expand / collapse

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/permissions

Section/Topic

Tool specific permission rules > bash

Current Documentation

The docs currently say

Claude Code is aware of shell operators (like &&) so a prefix match rule like Bash(safe-cmd *) won’t give it permission to run the command safe-cmd && other-cmd.

But doesn't explain what shell operators are included in this list and if commands like timeout hup xargs are included there.

What's Wrong or Missing?

I need to know what list of commands are part of this approval list. And more importantly: I need to expand the list. I use direnv to manage environments, and I'd love to give blanket permission to wrap commands in direnv exec or devbox run. I'm not sure if that exists and is undocumented, or if it's a feature request. Obviously, feel free to ask me to recreate a second one of these if this is actually a feature request.

Suggested Improvement

You should add a listing of the shell commands that Claude Code understands and show how to extend those (if possible).

Impact

High - Prevents users from using a feature

Additional Context

I can't 'always approve' commands like devbox run or direnv exec until I know if that means Claude can use it to devbox run rm -rf ~/Code. That makes my CC usage much less flexible.

extent analysis

TL;DR

The issue can be addressed by clarifying the list of shell operators recognized by Claude Code and potentially extending this list to include commands like direnv exec and devbox run.

Guidance

  • Review the documentation for any implicit or explicit mentions of supported shell operators beyond && to understand the current scope.
  • Investigate if there's an existing mechanism to extend or configure the list of recognized shell operators, which might be undocumented or not widely known.
  • Consider reaching out to the Claude Code support or development team to inquire about the possibility of adding direnv exec and devbox run to the list of approved commands or to understand the security implications of doing so.
  • Evaluate the security risks associated with approving commands like devbox run and direnv exec without full understanding of their implications, as highlighted in the issue.

Example

No specific code example is provided due to the nature of the issue focusing on documentation clarity and feature request rather than code implementation.

Notes

The solution hinges on whether Claude Code's documentation or support can provide a clear list of supported shell operators and a method to extend this list. The primary concern is balancing feature flexibility with security, ensuring that any extension does not introduce vulnerabilities like the hypothetical devbox run rm -rf ~/Code scenario.

Recommendation

Apply workaround: Until a comprehensive list of supported shell operators is available and a method to safely extend this list is understood, users may need to manually approve each command or seek alternative solutions that do not rely on unrecognized shell operators, prioritizing security over convenience.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Documentation on Permissions and Wrapper Commands [1 participants]