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.
- Quick Start
- Plugins
- MCP Servers
- Skills
- Tools
- Performance Optimizations
- Global Configuration
- Settings
- Repository Structure
# 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 CodePlugins extend Claude Code with new commands, agents, hooks, and behaviors.
> /plugin marketplace add <marketplace>
> /plugin install <plugin-name>Restart Claude Code after installation to activate.
| Marketplace | Command |
|---|---|
| Community | /plugin marketplace add anilcancakir/claude-code-plugins |
| Official | /plugin marketplace add claude-plugins-official |
| Laravel | /plugin marketplace add laravel |
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 |
| 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 |
| Plugin | Description |
|---|---|
laravel-simplifier |
Laravel-specific code patterns and best practices |
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)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 indexModel Context Protocol (MCP) servers connect Claude Code to external tools and data sources. Configure globally in ~/.claude.json.
{
"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 | 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 |
- Repository management (create, fork, search)
- Issues and pull requests (CRUD, review)
- Code search and file operations
- Branch and release management
Documentation lookup for libraries and frameworks:
# Usage pattern
mcp__context7__resolve-library-id # Resolve library first
mcp__context7__query-docs # Query documentationWeb 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 |
Automatic step-by-step reasoning for complex problem decomposition. No configuration required.
Skills provide domain-specific patterns and reference documentation. Located in skills/ directory.
| 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 |
| Skill | Description | Key Topics |
|---|---|---|
flutter-design |
Flutter implementation | Material 3, ThemeData, ColorScheme, TextTheme |
| 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 |
skills/<skill-name>/
├── SKILL.md # Main documentation with frontmatter
└── references/ # Detailed reference files
├── topic-1.md
└── topic-2.md
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
Optimizations based on ykdojo/claude-code-tips.
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"
}
}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.
[CUSTOMIZABLE] The global ~/.claude/CLAUDE.md file defines personal preferences applied to all sessions. Project-level CLAUDE.md files can override these settings.
# 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]# 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)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 |
[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 # Combinedeverything-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
- Claude Code Documentation
- anilcancakir/claude-code-plugins
- ykdojo/claude-code-tips
- Model Context Protocol
MIT License - Adapt freely for your own workflow.