claude-code - 💡(How to fix) Fix [FEATURE] Support user-level CLAUDE.md / custom instructions for claude.ai/code web sessions [1 comments, 2 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#47885Fetched 2026-04-15 06:39:31
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
Timeline (top)
labeled ×2commented ×1renamed ×1

Claude Code CLI and desktop support a user-level ~/.claude/CLAUDE.md for personal conventions (branch naming, commit style, workflow preferences, etc.) that apply across all projects automatically. The web version (claude.ai/code) has no equivalent — only a project-level CLAUDE.md committed to a repo is loaded in cloud sessions.

Root Cause

Claude Code CLI and desktop support a user-level ~/.claude/CLAUDE.md for personal conventions (branch naming, commit style, workflow preferences, etc.) that apply across all projects automatically. The web version (claude.ai/code) has no equivalent — only a project-level CLAUDE.md committed to a repo is loaded in cloud sessions.

Fix Action

Fix / Workaround

Currently, the only workaround is to either:

  1. Commit conventions to every individual repo's CLAUDE.md (noisy, not always appropriate for shared repos), or
  2. Use Remote Control to run Claude Code locally (defeats the purpose of the web version)
RAW_BUFFERClick to expand / collapse

Description

Claude Code CLI and desktop support a user-level ~/.claude/CLAUDE.md for personal conventions (branch naming, commit style, workflow preferences, etc.) that apply across all projects automatically. The web version (claude.ai/code) has no equivalent — only a project-level CLAUDE.md committed to a repo is loaded in cloud sessions.

Expected Behavior

Users can define personal instructions via a profile/settings page on claude.ai that are automatically applied to all Claude Code web sessions — similar to how ~/.claude/CLAUDE.md works for local sessions.

Actual Behavior

Web sessions only load CLAUDE.md from the repository. There is no user-level configuration surface on claude.ai for Claude Code personal instructions.

Use Case / Context

Personal conventions that shouldn't be committed to repos should still be usable in web sessions. Examples:

  • Branch naming format: feat/vann/{task-description}
  • Preferred commit message style
  • Personal workflow preferences (e.g. always ask before pushing)

Currently, the only workaround is to either:

  1. Commit conventions to every individual repo's CLAUDE.md (noisy, not always appropriate for shared repos), or
  2. Use Remote Control to run Claude Code locally (defeats the purpose of the web version)

Proposed Solution

Add a "Personal Instructions" or "Custom Instructions" section under the claude.ai user profile/settings that Claude Code web sessions load at startup — analogous to ~/.claude/CLAUDE.md on local installs.

extent analysis

TL;DR

Implement a user-level configuration surface on claude.ai for personal instructions to be applied across all web sessions.

Guidance

  • Introduce a "Personal Instructions" section in the user profile/settings page on claude.ai to store personal conventions.
  • Load these personal instructions at startup in Claude Code web sessions, similar to how ~/.claude/CLAUDE.md is loaded in local sessions.
  • Ensure the personal instructions are applied across all projects in web sessions, without requiring them to be committed to individual repositories.
  • Consider implementing a fallback mechanism to load repository-level CLAUDE.md files when personal instructions are not defined.

Example

No code snippet is provided as the issue does not contain specific implementation details.

Notes

The proposed solution aims to provide a consistent experience between local and web sessions, allowing users to define personal conventions without committing them to repositories. However, the implementation details and potential conflicts with repository-level configurations need to be carefully considered.

Recommendation

Apply workaround by implementing the proposed "Personal Instructions" section in the user profile/settings page on claude.ai, as it addresses the core issue of lacking a user-level configuration surface for personal instructions in web sessions.

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 [FEATURE] Support user-level CLAUDE.md / custom instructions for claude.ai/code web sessions [1 comments, 2 participants]