[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

  1. Create a CLAUDE.local.md under the current workspace.
  2. Use @imports (for instancd: @~/.xap-coding-assistant/claude-plugin/handbook/XAP.commonerror.md) in it. (Both relative and absolute path have a problem).
  3. 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_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗