opencode doesn't respect CLAUDE_CONFIG_DIR environment variable

Problem

Opencode hardcodes ~/.claude as the path for reading Claude Code configuration (CLAUDE.md and skills), but Claude Code v1.0.30+ changed its default config directory to ~/.config/claude and added support for the CLAUDE_CONFIG_DIR environment variable to override this.

This causes issues for users who:

Use CLAUDE_CONFIG_DIR to specify a custom config location
Have a file (not directory) at ~/.claude, causing ENOTDIR errors when opencode tries to glob inside it

Expected Behavior

Opencode should check for Claude config in this order:

CLAUDE_CONFIG_DIR environment variable (if set and is a valid directory)
~/.config/claude (new Claude Code default)
~/.claude (legacy path)

Affected Code

packages/opencode/src/session/system.ts - hardcodes ~/.claude/CLAUDE.md
packages/opencode/src/skill/skill.ts - hardcodes ~/.claude for skills

References

Claude Code configuration docs: https://docs.anthropic.com/en/docs/claude-code/settings
Claude Code v1.0.30 changed default from ~/.claude to ~/.config/claude

Fix submitted in #6550

This issue might be a duplicate of existing issues. Please check:

Does opencode actually support finding skills at .claude/skills? #6266: Does opencode actually support finding skills at .claude/skills? - Discusses configuration directory discovery
Skill discovery doesn't match Claude Code's skills/ directory structure #6177: Skill discovery doesn't match Claude Code's skills/ directory structure - Related to Claude Code config path compatibility
Global skills are not loaded #6292: Global skills are not loaded - Issue with global config directory (OPENCODE_CONFIG_DIR) not loading skills
[FEATURE]: Plugin Hook for Registering Additional Config Directories #6347: Plugin Hook for Registering Additional Config Directories - Feature request for config directory discovery
[FEATURE]: Support discovering Global Claude skills #6400: Support discovering Global Claude skills - Extension of Skill discovery doesn't match Claude Code's skills/ directory structure #6177 about global skill discovery

Feel free to ignore if none of these address your specific case.

Also hitting this via Anthropic Subscription (OAuth). When using Opus or Sonnet directly, OpenCode falls back to the hardcoded legacy config path instead of respecting the .opencode/ directory structure. Combined with #10567 (string replacement of "opencode" in paths), this creates a situation where config, agents and rules are read from and written to the wrong location entirely — making it impossible to rely on a consistent setup when switching models.

To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Navigation Menu

Repository navigation

opencode doesn't respect CLAUDE_CONFIG_DIR environment variable #6551

Problem

Expected Behavior

Affected Code

References

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

opencode doesn't respect CLAUDE_CONFIG_DIR environment variable #6551

Description

Problem

Expected Behavior

Affected Code

References

Activity

ramarivera commented on Dec 31, 2025

github-actions commented on Dec 31, 2025

attkri commented on Mar 5, 2026

github-actions commented on May 5, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions