[DOCS] Documentation incorrectly references deprecated `/allowed-tools` slash command instead of `/permissions`
Documentation Type
Unclear/confusing documentation
Documentation Location
Section/Topic
- In Settings: The "Tools available to Claude" section (under the table description). - In Slash commands: The "Bash command execution" section (under Custom slash commands).
Current Documentation
In docs/en/settings.md:
"Permission rules can be configured using /allowed-tools or in permission settings."
In docs/en/slash-commands.md:
"You must includeallowed-toolswith theBashtool..." (Context implies checking permissions via slash command interactions in other areas).
What's Wrong or Missing?
The documentation references the /allowed-tools slash command. However, according to the Changelog v1.0.7, this command was renamed:
"Renamed /allowed-tools -> /permissions"
While the CLI flag --allowedTools remains valid, the interactive slash command /allowed-tools is deprecated/removed in favor of /permissions. Directing users to use /allowed-tools in the REPL will likely result in a "command not found" error or confusion.
Suggested Improvement
Update the documentation to reference the correct slash command /permissions.
Suggested change for Settings:
"Permission rules can be configured using /permissions or in permission settings."
Impact
High - Prevents users from using a feature
Additional Context
- Source of truth:
claude_code_changelog.md- Version 1.0.7 - Excerpt from Changelog:
> ## 1.0.7
> - Renamed /allowed-tools -> /permissions
> - Migrated allowedTools and ignorePatterns from .claude.json -> settings.json
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗