Documentation

Resources

Resources are read-only content that Claude Code can access. Create reference materials, documentation snippets, or any context that your AI assistant can retrieve when needed.

Overview

Resources provide a way to store static content that the AI can read but not modify. Unlike commands (which are prompts) or skills (which are instructions), resources are reference materials the AI can consult.

Common use cases include:

  • API documentation — Store API specs or endpoint references
  • Code snippets — Reference implementations or patterns
  • Configuration templates — Standard config files or schemas
  • Style guides — Writing or coding style documentation
  • Project context — Architecture decisions or project-specific info

Creating a Resource

To create a new resource:

  1. Navigate to your workspace
  2. Click the Resources tab
  3. Click New Resource
  4. Fill in the resource details:
    • TypeDocument (markdown content) or URL (an external page). Chosen at creation and cannot be changed afterward.
    • Name — The resource name in kebab-case (e.g., api-reference)
    • Description — A brief description of what this resource contains
    • Content (document) — the markdown body, authored on the next screen; or URL (url) — a public http(s) page the agent can reach.
  5. Click Create

Resource types

A resource is one of two types, picked when you create it (the type is then locked):

  • Document — embedded markdown content (up to 10,000 characters), authored on a dedicated editor page. File icon.
  • URL — an external web page delivered as a link rather than embedded text. Globe icon. When Claude Code reads the resource it gets a short heads-up plus the URL, and fetches the page itself with its web-fetch tool if it has one available — nothing is asked of the agent. The URL must be a public http(s) page the agent can reach (no auth-gated or internal pages).

Use a URL resource to point Claude at living docs (a changelog, an API reference, a status page) without copying their content into the workspace.

Accessing Resources

Resources are available in Claude Code as read-only content. The AI can access resources by name to retrieve their content.

How resources work

Claude Code can list your available resources and read their contents on demand. This is different from commands (prompts) and skills (instructions).

Enabling & Disabling Resources

Resources can be enabled or disabled:

  1. Open the resource card menu (three dots)
  2. Click Enable or Disable
  3. Disabled resources appear dimmed and won't be accessible in Claude Code

Favorites

Mark frequently used resources as favorites for quick access:

  1. Go to the Resources page
  2. Find the resource you want to favorite
  3. Click the star icon on the resource card

Favorited resources appear at the top of your resources list, making them easy to find. Click the star icon again to remove a resource from your favorites.

Personal favorites

Favorites are personal to your account. Other workspace members won't see your favorites, and you won't see theirs.

Exporting Resources

Resources can be exported as JSON files for backup or sharing:

  1. Open the resource card menu (three dots)
  2. Click Export as JSON
  3. The resource will be downloaded as a JSON file

The exported JSON format:

json
{
  "name": "api-reference",
  "description": "REST API endpoint documentation",
  "content": "## Users API\n\nGET /users - List all users\nPOST /users - Create a user\n..."
}

Importing Resources

Import resources from JSON files:

  1. Click the Import button next to "New Resource"
  2. Drag and drop a JSON file or click to browse
  3. The system validates the JSON structure
  4. Preview shows resource name and description
  5. Click Import Resource to create it

Note: If a resource with the same name exists, it will be auto-renamed (e.g., "api-reference" → "api-reference-2").

Content Limits

Resources have the following content limits:

Field Limit
Name 30 characters
Description 200 characters
Content 10,000 characters

Pricing

Resources are charged each time they are read in Claude Code.

Free tier

Free billing accounts are not charged for resources. See Billing Account Tiers for more information.

Item Cost
Per resource read 0.2 credits

See Billing & Credits for more details on credit management and purchasing.

Workspace Limits

The number of resources per workspace depends on your billing account tier. See Workspace Item Limits for details.

Resources vs Commands

Understanding when to use resources versus commands:

Feature Resources Commands
Purpose Reference content the AI reads Prompts that trigger AI actions
Type Reference (read-only) Prompts (executable)
Arguments No Yes (up to 3)
Use case Documentation, context Actions, workflows