[DOCS] Documentation incorrectly references deprecated `/allowed-tools` slash command instead of `/permissions`

Resolved 💬 3 comments Opened Jan 19, 2026 by coygeek Closed Feb 27, 2026

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 include allowed-tools with the Bash tool..." (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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗