[BUG] The import doesn't work in CLAUDE.local.md in Claude Code VSCode extension
Resolved 💬 3 comments Opened Feb 28, 2026 by Jasmine728-Y Closed Mar 3, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
I created a CLAUDE.local.md with some @imports to import other .md files in it. But the Claude Code VSCode extension cannot successfully import the contents of these imported files while Claude Code CLI works.
In VSCode extension, it said:
Yes, I can confirm that my system prompt includes a reference to the XAP Common Error handbook. In [CLAUDE.local.md](vscode-webview://1s49g2q704g0cn7ibelvsio1c1c597ge57ab8dot003o5ui22re4/CLAUDE.local.md), there is this line:
@~/.xap-coding-assistant/claude-plugin/handbook/XAP.commonerror.md
However, this is an @-reference (file inclusion directive). Whether the actual content of that file is loaded into my context depends on whether the system resolved that reference and injected the file contents.
Let me check if I actually have the content available by looking at what I know. I do not see the actual contents of XAP.commonerror.md expanded in my current context — I only see the reference path. This means the @-import was likely not resolved, and I don't have the common error handbook content available in this session.
Would you like me to read that file directly so I can use it?
What Should Happen?
It should work as the Claude Code CLI:
Yes, I have the XAP Common Errors Handbook loaded. It covers these four common errors:
1. ObjectStoreSubResponse_2 type not found — ObjectStoreSubResponse has only one generic parameter (the value type), not three.
2. Xap.Codec namespace not found — Use pluginServices.CreateInstance<LegacyQueryResponseData>() instead of manually creating internal XAP codec types.
3. Interface methods not available in workflow tests — SetEnvironment, SetStaticVariant, AwaitAllNodes, GetExecutionContext exist on the Workflow base class, not on generated IWorkflow_* interfaces. 4. ObjectStore assembly reference in workflow tests — Accessing ObjectStore plugin properties on a workflow requires the Xap.Platform assembly reference.
Error Messages/Logs
Steps to Reproduce
- Create a CLAUDE.local.md under the current workspace.
- Use @imports (for instancd: @~/.xap-coding-assistant/claude-plugin/handbook/XAP.commonerror.md) in it. (Both relative and absolute path have a problem).
- Ask the Claude in VSCode extension to verify if the content is correctly imported. (Example prompt: "Please confirm if you import the content of xap common error handbook in your system prompt.")
Claude Model
Opus
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.61
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
Other
Additional Information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗