claude-code-platform-reference

Document Claude Code configuration resolution, plugin installation, and hook registration.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/taloncjones/dotfiles --skill claude-code-platform-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-platform-reference
Source: https://github.com/taloncjones/dotfiles/tree/main/.claude/skills/claude-code-platform-reference
Command: npx skills add https://github.com/taloncjones/dotfiles --skill claude-code-platform-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill serves as a comprehensive guide to understanding the Claude Code platform's inner workings, configuration, and key components.

Core Features & Use Cases

  • Platform Mechanics: Offers in-depth information about the Claude Code platform, including configuration directory resolution and environment variables.
  • Config-Dir Resolution: Describes how CLAUDE_CONFIG_DIR and the default .claude directory work.
  • Cloud Container Configuration: Details environment variables, launch ordering, and status line wiring within cloud containers.
  • Skills, Commands, and Agents: Explains the difference between skills, commands, agents, and hooks in Claude Code.
  • @import in CLAUDE.md: Describes how CLAUDE.md uses @import for in-session file loading and its relationship with project-level settings.
  • Quick Reference for Hook Events and Matchers: Provides quick access to exit code meanings, registered hooks, and matcher types for event matching.

Quick Start

Load this reference when exploring Claude Code's mechanics, particularly for troubleshooting configuration issues or understanding plugin/marketplace internals.

Frequently Asked Questions about claude-code-platform-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does Claude Code configuration directory resolution work?

Claude Code configuration directory resolution prioritizes the `CLAUDE_CONFIG_DIR` environment variable, falling back to the default `.claude` directory if unset. This mechanism manages user-level settings and project-specific configurations.

What is the difference between skills, commands, agents, and hooks in Claude Code?

Skills, commands, agents, and hooks are distinct Claude Code components. This reference details their differences, specifically explaining how hook registration and session lifecycle events function within the platform.

How do I configure environment variables and launch ordering for Claude Code cloud containers?

Configure Claude Code cloud containers by setting specific environment variables and managing launch ordering. This reference details status line wiring and cloud container configuration to ensure proper session initialization.

Can I use @import in CLAUDE.md to load project-level settings?

Yes, CLAUDE.md uses `@import` for in-session file loading. This feature directly integrates with project-level settings to manage environment configurations and load external references during active sessions.

How do I troubleshoot Claude Code plugin installation and hook event matchers?

Troubleshoot Claude Code plugin installation by reviewing exit code meanings, registered hooks, and matcher types. This reference provides a quick reference guide for event matching and marketplace management internals.

Why are my Claude Code user-level settings not overriding project configurations?

Claude Code configuration resolution applies a specific hierarchy between user-level settings and project-specific configurations. Understanding `CLAUDE_CONFIG_DIR` mechanics and project-level settings precedence resolves override conflicts.