Extend working directories with --add-dir

Use --add-dir at launch (or /add-dir mid-session) to give Claude read/edit access to directories outside the project root for the current session. Persist the same grant with permissions.additionalDirectories.

bash

# Launch with two extra working directories
claude --add-dir ../shared-types --add-dir ../design-tokens

# Or persist the grant for every future session in this project — add
# the keys below into .claude/settings.json by hand. DO NOT overwrite the
# whole file with `cat >` because it can wipe existing permissions, hooks,
# or team settings that are already in there.
#
# {
#   "permissions": {
#     "additionalDirectories": [
#       "../shared-types",
#       "../design-tokens"
#     ]
#   }
# }
#
# If the file doesn't exist yet, you can create it from scratch:
#   test -f .claude/settings.json || cat > .claude/settings.json <<'JSON'
#   ... JSON above ...
#   JSON

# Note: .claude/ configuration inside the added paths is NOT loaded.
# Only file read/edit access is granted.