# 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](#quick-start)
- [Plugins](#plugins)
- [MCP Servers](#mcp-servers)
- [Skills](#skills)
- [Tools](#tools)
- [Performance Optimizations](#performance-optimizations)
- [Global Configuration](#global-configuration)
- [Settings](#settings)
- [Repository Structure](#repository-structure)
---
## Quick Start
```bash
# 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
```bash
> /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](https://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:
```bash
# [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:
```bash
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
```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 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:
```bash
# 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.
```bash
# 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](https://github.com/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](https://github.com/ykdojo/claude-code-tips/tree/main/system-prompt) for patch scripts.
**Preserve patches:** Disable auto-updates in settings:
```json
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
```
### Lazy-Load MCP Tools
MCP tool definitions consume context even when unused. Enable on-demand loading:
```json
{
"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
```markdown
# 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
```markdown
# 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`:
```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`:
```bash
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 |
```bash
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](https://code.claude.com/docs)
- [anilcancakir/claude-code-plugins](https://github.com/anilcancakir/claude-code-plugins)
- [ykdojo/claude-code-tips](https://github.com/ykdojo/claude-code-tips)
- [Model Context Protocol](https://modelcontextprotocol.io)
---
## License
MIT License - Adapt freely for your own workflow.