[DOCS] Docs about claude_project.toml for eg. multirepo projects

Resolved 💬 4 comments Opened Sep 8, 2025 by schmunk42 Closed Sep 9, 2025

Documentation Type

Missing documentation (feature not documented)

Documentation Location

Claude suggested and created the file

Section/Topic

Project Configuration

Current Documentation

https://docs.anthropic.com/en/docs/claude-code/settings

Nothing about toml at all

What's Wrong or Missing?

Claude itself recommended and created the following file in .claude/claude_project.toml:

  # Claude Code Project Configuration
  # This file adds additional paths to the project context

  [context]
  # Additional working directories (can be relative or absolute)
  additional_working_directories = [
      "../related-microservice",
      "../../shared-libraries/common-utils",
      "/home/user/projects/data-pipeline",
      "~/workspace/company/analytics-dashboard"
  ]

  # Optional: Restrict allowed operations on the additional directories
  # allowed_operations = ["Read"]

Suggested Improvement

I can not find anything about claude_project.toml or even toml files in general for configuration.

Updated the docs and/or provide a way how to detect bleeding edge features.

Impact

Medium - Makes feature difficult to understand

Additional Context

The feature works fine, there's just zero documentation.

View original on GitHub ↗

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