My Claude Code
Production-grade Claude Code configuration reference. This guide documents plugins, MCP servers, skills, tools, and optimizations for AI-assisted development workflows.
Note: Sections marked with
[CUSTOMIZABLE]contain personal preferences. Adapt these to your own tech stack and workflow.
Table of Contents
- Quick Start
- Plugins
- MCP Servers
- Skills
- Tools
- Performance Optimizations
- Global Configuration
- Settings
- Repository Structure
Quick Start
# 1. Install plugins
> /plugin marketplace add anilcancakir/claude-code-plugins
> /plugin marketplace add claude-plugins-official
> /plugin install <plugin-name>
# 2. Configure MCP servers in ~/.claude.json
# 3. Create ~/.claude/CLAUDE.md with personal preferences
# 4. Restart Claude Code
Plugins
Plugins extend Claude Code with new commands, agents, hooks, and behaviors.
Installation
> /plugin marketplace add <marketplace>
> /plugin install <plugin-name>
Restart Claude Code after installation to activate.
Available Marketplaces
| Marketplace | Command |
|---|---|
| Community | /plugin marketplace add anilcancakir/claude-code-plugins |
| Official | /plugin marketplace add claude-plugins-official |
| Laravel | /plugin marketplace add laravel |
Plugin Reference
Community Plugins (anilcancakir/claude-code-plugins)
Source: github.com/anilcancakir/claude-code-plugins
| Plugin | Description | Commands |
|---|---|---|
strategic-compact | Phase-aware context compaction suggestions | Auto-triggered |
serena-integration | Serena MCP integration for semantic navigation | /serena-navigator, /serena-refactor, /serena-memory |
dart-lsp | Dart/Flutter language server integration | Go-to-definition, references, hover |
pre-commit-flow | Code review, documentation, and commit automation | /my_review, /my_docs, /my_commit, /my_send |
idea-research | Business research and idea validation | /my_research [topic] --quick|--standard|--deep |
implementation-planner | Structured planning with TDD support | /my_plan, /my_tdd, /my_execute |
project-optimizer | Project setup and CLAUDE.md generation | /my_project, /my_brand, /my_setup, /my_audit |
Official Plugins (claude-plugins-official)
| Plugin | Description |
|---|---|
code-simplifier | Refines code for clarity and maintainability |
learning-output-style | Interactive learning mode with explanations |
ralph-loop | Autonomous development loop for complex tasks |
php-lsp | PHP language server integration |
security-guidance | Security best practices and vulnerability detection |
Laravel Plugins
| Plugin | Description |
|---|---|
laravel-simplifier | Laravel-specific code patterns and best practices |
Plugin Configuration
Strategic Compact
Environment variables for compaction thresholds:
# [CUSTOMIZABLE] Adjust thresholds based on your workflow
export STRATEGIC_COMPACT_T1=50 # First suggestion (tool calls)
export STRATEGIC_COMPACT_T2=75 # Second suggestion
export STRATEGIC_COMPACT_T3=100 # Strong recommendation
export STRATEGIC_COMPACT_TIME=1800 # Time threshold (seconds)
Serena Integration
Requires Serena MCP server setup per project:
cd /path/to/your/project
claude mcp add serena -- uvx --from git+https://github.com/oraios/serena \
serena start-mcp-server --context claude-code --project $(pwd)
uvx --from git+https://github.com/oraios/serena serena project create
uvx --from git+https://github.com/oraios/serena serena project index
MCP Servers
Model Context Protocol (MCP) servers connect Claude Code to external tools and data sources. Configure globally in ~/.claude.json.
Configuration Template
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp",
"headers": {
"Authorization": "Bearer <GITHUB_TOKEN>"
}
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"CONTEXT7_API_KEY": "<API_KEY>"
}
},
"skillsmp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "skillsmp-mcp-server"],
"env": {
"SKILLSMP_API_KEY": "<API_KEY>"
}
},
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "<API_KEY>"
}
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
Note: Replace
<API_KEY>and<GITHUB_TOKEN>placeholders with your actual credentials.
Server Reference
| Server | Type | Purpose | Requires API Key |
|---|---|---|---|
github | HTTP | GitHub API (issues, PRs, repos, code search) | Yes |
context7 | HTTP | Library documentation lookup | Yes |
skillsmp | stdio | Skills marketplace discovery | Yes |
firecrawl | stdio | Web scraping and content extraction | Yes |
sequential-thinking | stdio | Step-by-step reasoning | No |
Server Capabilities
GitHub MCP
- Repository management (create, fork, search)
- Issues and pull requests (CRUD, review)
- Code search and file operations
- Branch and release management
Context7
Documentation lookup for libraries and frameworks:
# Usage pattern
mcp__context7__resolve-library-id # Resolve library first
mcp__context7__query-docs # Query documentation
Firecrawl
Web content extraction tools:
| Tool | Purpose |
|---|---|
firecrawl_scrape | Extract content from single URL |
firecrawl_crawl | Crawl entire website |
firecrawl_search | Search and extract from web |
firecrawl_map | Discover URLs on a website |
Sequential Thinking
Automatic step-by-step reasoning for complex problem decomposition. No configuration required.
Skills
Skills provide domain-specific patterns and reference documentation. Located in skills/ directory.
Skill Categories
Laravel Skills
| Skill | Description | Key Topics |
|---|---|---|
laravel-api-architect | API development patterns | Service-Repository, Sanctum/Passport, API Resources, FormRequests |
laravel-fullstack | Frontend integration | Blade, Alpine.js, Vue.js, TailwindCSS v4, Vite |
laravel-infrastructure | Backend services | Horizon, Octane, Reverb, Redis, PostgreSQL |
laravel-packages | Third-party packages | Filament v4, Debugbar, SEOTools |
laravel-testing | Testing patterns | PHPUnit, Dusk, factories, assertions |
Flutter Skills
| Skill | Description | Key Topics |
|---|---|---|
flutter-design | Flutter implementation | Material 3, ThemeData, ColorScheme, TextTheme |
Design Skills
| Skill | Description | Key Topics |
|---|---|---|
web-design-mastery | Web UI principles | Refactoring UI, hierarchy, spacing, typography |
tailwindcss-design | TailwindCSS patterns | Utilities, dark mode, responsive, components |
mobile-app-design-mastery | Mobile UI design | Touch targets, spacing, platform-aware depth |
Skill Structure
skills/<skill-name>/
├── SKILL.md # Main documentation with frontmatter
└── references/ # Detailed reference files
├── topic-1.md
└── topic-2.md
Tools
ccstatusline
Interactive TUI for configuring Claude Code status line widgets.
# No installation required
npx ccstatusline@latest # npm
bunx ccstatusline@latest # Bun (faster)
Features:
- Multiple status line configurations
- Widget management (add, remove, reorder)
- Color customization per widget
- Flex separator behavior
- Real-time preview
- Auto-install to Claude Code settings
Configuration location: ~/.config/ccstatusline/settings.json
Performance Optimizations
Optimizations based on ykdojo/claude-code-tips.
System Prompt Patching
Reduce system overhead by patching the CLI bundle:
| Component | Before | After | Savings |
|---|---|---|---|
| System prompt | 3.0k | 1.8k | 1,200 tokens |
| System tools | 15.6k | 7.4k | 8,200 tokens |
| Total | ~19k | ~9k | ~10k tokens (~50%) |
Benefits:
- Extended context for actual work
- Longer conversations before compaction
- Reduced token costs
See system-prompt folder for patch scripts.
Preserve patches: Disable auto-updates in settings:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Lazy-Load MCP Tools
MCP tool definitions consume context even when unused. Enable on-demand loading:
{
"env": {
"ENABLE_TOOL_SEARCH": "true"
}
}
Note: As of version 2.1.7, lazy-loading activates automatically when MCP tools exceed 10% of context window.
Global Configuration
CLAUDE.md
[CUSTOMIZABLE] The global ~/.claude/CLAUDE.md file defines personal preferences applied to all sessions. Project-level CLAUDE.md files can override these settings.
Template Structure
# Personal Claude Instructions
## About Me
<!-- [CUSTOMIZABLE] Your role and context -->
- Role: [Your role]
- Environment: [Your infrastructure]
- Constraints: [Any limitations]
## Tech Stack
<!-- [CUSTOMIZABLE] Your technology preferences -->
| Layer | Technology |
|-------|------------|
| Backend | [Framework, Language] |
| Frontend | [Framework, Libraries] |
| Database | [Database system] |
| Cache/Queue | [Caching layer] |
## Coding Standards
<!-- [CUSTOMIZABLE] Your coding conventions -->
### Language
- Code, comments, documentation: [Language]
- Communication: [Language]
### Documentation
- [Documentation requirements]
### Patterns
- [Design patterns and architecture]
### Workflow
- [Development workflow preferences]
## Constraints
<!-- [CUSTOMIZABLE] Hard rules -->
- NEVER [prohibited actions]
- ALWAYS [required actions]
Example Configuration
# Personal Claude Instructions
## About Me
- Senior Full-Stack Developer
- Solo developer (coding, design, decisions)
- Self-hosted Ubuntu server, no cloud services
## Tech Stack
| Layer | Technology |
|-------|------------|
| Backend | Laravel (API), PHP 7.4+ |
| Frontend | Nuxt.js v2, Vue v2, TailwindCSS |
| Database | PostgreSQL |
| Cache/Queue | Redis |
## Coding Standards
### Language
- Code, comments, documentation: English only
- Communication: Turkish allowed
### Documentation
- PHPDoc for classes, public methods, complex private methods
- JSDoc/VueDoc for Vue components and composables
- Inline comments for complex logic only
### Patterns
- SOLID principles
- Service-Repository pattern (Laravel)
- Options API (Vue 2)
- Vuex for state management
### Workflow
- TDD by default
- Linter always runs (Pint, ESLint)
- Git operations require explicit approval
## Constraints
- NEVER run dev/serve/build commands
- NEVER git push/commit without approval
- NEVER skip linting
- NEVER use Turkish in code
- NEVER use LIKE for PostgreSQL (use ILIKE)
- NEVER return raw arrays from controllers (use JsonResource)
Settings
Environment Variables
Configure in ~/.claude/settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1",
"ENABLE_TOOL_SEARCH": "true",
"EDITOR": "nano"
}
}
| Variable | Purpose | Values |
|---|---|---|
DISABLE_AUTOUPDATER | Prevent automatic updates | "1" to disable |
ENABLE_TOOL_SEARCH | Lazy-load MCP tools | "true" to enable |
EDITOR | Default editor for file operations | Editor command |
Shell Wrapper
[CUSTOMIZABLE] Optional wrapper function for convenience flags.
Add to ~/.zshrc or ~/.bashrc:
claude() {
local args=()
local use_local=false
for arg in "$@"; do
case "$arg" in
-f)
args+=("--dangerously-skip-permissions")
;;
--local)
use_local=true
;;
*)
args+=("$arg")
;;
esac
done
if $use_local; then
ANTHROPIC_API_KEY="<YOUR_API_KEY>" \
command claude "${args[@]}"
else
command claude "${args[@]}"
fi
}
Usage:
| Flag | Description |
|---|---|
-f | Skip permission prompts |
--local | Use local API key instead of default |
claude # Normal
claude -f # Fast mode (skip permissions)
claude --local # Local API key
claude -f --local # Combined
Repository Structure
everything-my-claude-code/
├── README.md # This configuration guide
└── skills/ # Reference skill documentation
├── laravel-api-architect/ # API patterns
├── laravel-fullstack/ # Frontend integration
├── laravel-infrastructure/ # Backend services
├── laravel-packages/ # Third-party packages
├── laravel-testing/ # Testing patterns
├── flutter-design/ # Flutter implementation
├── web-design-mastery/ # Web UI principles
├── tailwindcss-design/ # TailwindCSS patterns
└── mobile-app-design-mastery/ # Mobile UI design
References
- Claude Code Documentation
- anilcancakir/claude-code-plugins
- ykdojo/claude-code-tips
- Model Context Protocol
License
MIT License - Adapt freely for your own workflow.