[DOCS]: Document ~/.claude/CLAUDE.md compatibility behavior #8265
Description
Problem
OpenCode has Claude Code compatibility features that are inconsistently documented:
| Feature | Documented? | Where? |
|---|---|---|
~/.claude/skills/ |
Yes | Skills docs |
.claude/skills/ (project) |
Yes | Skills docs |
~/.claude/CLAUDE.md |
No | - |
Project-level CLAUDE.md |
No | - |
OPENCODE_DISABLE_CLAUDE_CODE* env vars |
Partially | CLI docs (env var table only) |
The Rules documentation mentions CLAUDE.md only as a comparison ("similar to CLAUDE.md or Cursor's rules") but doesn't explain that OpenCode actually reads these files.
Affected Code
packages/opencode/src/session/system.ts#L65-L73- loadsCLAUDE.md(project) and~/.claude/CLAUDE.md(global)packages/opencode/src/skill/skill.ts#L78-L79- scans~/.claude/skills/
Proposed Changes
Update the Rules documentation to:
- Mention that
CLAUDE.mdworks as an alternative toAGENTS.md(project-level) - Document
~/.claude/CLAUDE.mdsupport (global) - Add a "Claude Code Compatibility" section that consolidates all compatibility features
- Document all three
OPENCODE_DISABLE_CLAUDE_CODE*environment variables - Cross-reference the Skills documentation for
~/.claude/skills/
Related Issues
- opencode doesn't respect CLAUDE_CONFIG_DIR environment variable #6551 - opencode doesn't respect CLAUDE_CONFIG_DIR environment variable
- [FEATURE]: Support loading Claude Code plugins from .claude/ directory #8158 - Support loading Claude Code plugins from .claude/ directory
- [FEATURE]: Add .claude/commands/ compatibility (like .claude/skills/) #6985 - Add .claude/commands/ compatibility