My daily battle-tested Claude Code/Desktop and OpenAI Codex setup with skills, commands, hooks, subagents and MCP servers.

Installation • Plugins • Configuration • Statusline • References

Installation

Prerequisites: Before installing, ensure you have Claude Code and required tools installed. See INSTALL.md for complete prerequisites.

Install agents, commands, hooks, skills, and MCP servers via Claude Code Plugins system:

# Add marketplace
/plugin marketplace add fcakyon/claude-codex-settings

# Install plugins (pick what you need)
/plugin install azure-tools@fcakyon-claude-plugins        # Azure MCP & Skills (40+ services)
/plugin install ccproxy-tools@fcakyon-claude-plugins      # Use any LLM via ccproxy/LiteLLM
/plugin install claude-tools@fcakyon-claude-plugins       # Sync CLAUDE.md + allowlist
/plugin install gcloud-tools@fcakyon-claude-plugins       # GCloud MCP & Skills
/plugin install general-dev@fcakyon-claude-plugins        # Code simplifier + utilities
/plugin install github-dev@fcakyon-claude-plugins         # Git workflow + GitHub MCP
/plugin install linear-tools@fcakyon-claude-plugins       # Linear MCP & Skills
/plugin install mongodb-tools@fcakyon-claude-plugins      # MongoDB MCP & Skills (read-only)
/plugin install notification-tools@fcakyon-claude-plugins # OS notifications
/plugin install paper-search-tools@fcakyon-claude-plugins # Paper Search MCP & Skills
/plugin install playwright-tools@fcakyon-claude-plugins   # Playwright MCP + E2E skill
/plugin install plugin-dev@fcakyon-claude-plugins         # Plugin development toolkit
/plugin install slack-tools@fcakyon-claude-plugins        # Slack MCP & Skills
/plugin install supabase-tools@fcakyon-claude-plugins     # Supabase MCP & Skills
/plugin install tavily-tools@fcakyon-claude-plugins       # Tavily MCP & Skills
/plugin install ultralytics-dev@fcakyon-claude-plugins    # Auto-formatting hooks

After installing MCP plugins, run /plugin-name:setup for configuration (e.g., /slack-tools:setup).

Then create symlink for cross-tool compatibility:

ln -s CLAUDE.md AGENTS.md

Restart Claude Code to activate.

Plugins

azure-tools - Azure MCP & Skills

40+ Azure services with Azure CLI authentication. Run /azure-tools:setup after install.

Skills:

• azure-usage - Best practices for Azure
• setup - Troubleshooting guide

Commands:

• /azure-tools:setup - Configure Azure MCP

MCP: .mcp.json | microsoft/mcp/Azure.Mcp.Server

ccproxy-tools - Use Claude Code with any LLM

Configure Claude Code to use ccproxy/LiteLLM with Claude Pro/Max subscription, GitHub Copilot, or other providers. Run /ccproxy-tools:setup after install.

Commands:

• /ccproxy-tools:setup - Configure ccproxy/LiteLLM

Skills:

• setup - Troubleshooting guide

claude-tools - Sync CLAUDE.md + allowlist + context refresh

Commands for syncing CLAUDE.md and permissions allowlist from repository, plus context refresh for long conversations.

Commands:

• /load-claude-md - Refresh context with CLAUDE.md instructions
• /load-frontend-skill - Load frontend design skill from Anthropic
• /sync-claude-md - Sync CLAUDE.md from GitHub
• /sync-allowlist - Sync permissions allowlist

gcloud-tools - GCloud MCP & Skills

Logs, metrics, and traces. Run /gcloud-tools:setup after install.

Skills:

• gcloud-usage - Best practices for GCloud Logs/Metrics/Traces
• setup - Troubleshooting guide

Commands:

• /gcloud-tools:setup - Configure GCloud MCP

MCP: .mcp.json | google-cloud/observability-mcp

general-dev - Code simplifier + utilities

Code quality agent and utility hooks.

Agent:

• code-simplifier - Ensures code follows conventions

Hooks:

• enforce_rg_over_grep.py - Suggest ripgrep

github-dev - Git workflow agents + commands

Git and GitHub automation. Run /github-dev:setup after install.

Agents:

• commit-creator - Intelligent commit workflow
• pr-creator - Pull request creation
• pr-reviewer - Code review agent

Commands:

• /commit-staged - Commit staged changes
• /create-pr - Create pull request
• /review-pr - Review pull request
• /clean-gone-branches - Clean deleted branches

linear-tools - Linear MCP & Skills

Issue tracking with OAuth. Run /linear-tools:setup after install.

Skills:

• linear-usage - Best practices for Linear
• setup - Troubleshooting guide

Commands:

• /linear-tools:setup - Configure Linear MCP

MCP: .mcp.json | Linear MCP Docs

mongodb-tools - MongoDB MCP & Skills

Database exploration (read-only). Run /mongodb-tools:setup after install.

Skills:

• mongodb-usage - Best practices for MongoDB
• setup - Troubleshooting guide

Commands:

• /mongodb-tools:setup - Configure MongoDB MCP

MCP: .mcp.json | mongodb-js/mongodb-mcp-server

notification-tools - OS notifications

Desktop notifications when Claude Code completes tasks.

Hooks:

• notify.sh - OS notifications on task completion

paper-search-tools - Paper Search MCP & Skills

Search papers across arXiv, PubMed, IEEE, Scopus, ACM. Run /paper-search-tools:setup after install. Requires Docker.

Skills:

• paper-search-usage - Best practices for paper search
• setup - Troubleshooting guide

Commands:

• /paper-search-tools:setup - Configure Paper Search MCP

MCP: .mcp.json | mcp/paper-search

playwright-tools - Playwright MCP & Skills

Browser automation via MCP. Run /playwright-tools:setup after install. May require npx playwright install for browser binaries.

Skills:

• playwright-testing - E2E testing best practices

Commands:

• /playwright-tools:setup - Configure Playwright MCP

MCP: .mcp.json | microsoft/playwright-mcp

plugin-dev - Plugin development toolkit

Complete toolkit for building Claude Code plugins with skills, agents, and validation.

Skills:

• hook-development - Create hooks with prompt-based API
• mcp-integration - Configure MCP servers
• plugin-structure - Plugin layout and auto-discovery
• plugin-settings - Per-project configuration
• command-development - Create custom commands
• agent-development - Build autonomous agents
• skill-development - Create reusable skills with progressive disclosure

Agents:

• agent-creator - AI-assisted agent generation
• plugin-validator - Validate plugin structure
• skill-reviewer - Improve skill quality

Commands:

• /plugin-dev:create-plugin - 8-phase guided plugin workflow
• /plugin-dev:load-skills - Load all plugin development skills

Hooks:

• validate_skill.py - Validates SKILL.md structure
• validate_mcp_hook_locations.py - Validates MCP/hook file locations
• validate_plugin_paths.py - Validates plugin.json paths
• validate_plugin_structure.py - Validates plugin directory structure
• sync_marketplace_to_plugins.py - Syncs marketplace.json to plugin.json

slack-tools - Slack MCP & Skills

Message search and channel history. Run /slack-tools:setup after install.

Skills:

• slack-usage - Best practices for Slack MCP
• setup - Troubleshooting guide

Commands:

• /slack-tools:setup - Configure Slack MCP

MCP: .mcp.json | ubie-oss/slack-mcp-server

supabase-tools - Supabase MCP & Skills

Database management with OAuth. Run /supabase-tools:setup after install.

Skills:

• supabase-usage - Best practices for Supabase MCP
• setup - Troubleshooting guide

Commands:

• /supabase-tools:setup - Configure Supabase MCP

MCP: .mcp.json | supabase-community/supabase-mcp

tavily-tools - Tavily MCP & Skills

Web search and content extraction. Run /tavily-tools:setup after install.

Skills:

• tavily-usage - Best practices for Tavily Search
• setup - Troubleshooting guide

Commands:

• /tavily-tools:setup - Configure Tavily MCP

MCP: .mcp.json | tavily-ai/tavily-mcp

ultralytics-dev - Auto-formatting hooks

Auto-formatting hooks for Python, JavaScript, Markdown, and Bash.

Hooks:

• format_python_docstrings.py - Google-style docstring formatter
• python_code_quality.py - Python code quality with ruff
• prettier_formatting.py - JavaScript/TypeScript/CSS/JSON
• markdown_formatting.py - Markdown formatting
• bash_formatting.py - Bash script formatting

---

Configuration

Claude Code

Configuration in .claude/settings.json:

• Model: OpusPlan mode (plan: Opus 4.5, execute: Opus 4.5, fast: Sonnet 4.5) - source
• Environment: bash working directory, telemetry disabled, MCP output limits
• Permissions: bash commands, git operations, MCP tools
• Statusline: Custom usage tracking powered by ccusage
• Plugins: All plugins enabled

Z.ai (85% cheaper)

Configuration in .claude/settings-zai.json using Z.ai GLM models via Anthropic-compatible API:

• Main model: GLM-4.6 (dialogue, planning, coding, complex reasoning)
• Fast model: GLM-4.5-Air (file search, syntax checking)
• Cost savings: 85% cheaper than Claude 4.5 - source
• API key: Get from z.ai/model-api

Kimi K2

Run Claude Code with Kimi K2 via Anthropic-compatible API - source:

• Thinking model: kimi-k2-thinking-turbo - High-speed thinking, 256K context
• Fast model: kimi-k2-turbo-preview - Without extended thinking
• API key: Get from platform.moonshot.ai

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic/"
export ANTHROPIC_API_KEY="your-moonshot-api-key"
export ANTHROPIC_MODEL=kimi-k2-thinking-turbo
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2-thinking-turbo
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2-thinking-turbo
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2-thinking-turbo
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2-thinking-turbo

OpenAI Codex

Configuration in ~/.codex/config.toml:

• Model: gpt-5-codex with model_reasoning_effort set to "high"
• Provider: Azure via responses API surface
• Auth: Project-specific base URL with env_key authentication

ccproxy (Use Claude Code with Any LLM)

Assign any API or model to any task type via ccproxy:

• MAX/Pro subscription: Uses OAuth from your Claude subscription (no API keys)
• Any provider: OpenAI, Gemini, Perplexity, local LLMs, or any OpenAI-compatible API
• Fully customizable: Assign different models to default, thinking, planning, background tasks
• SDK support: Works with Anthropic SDK and LiteLLM SDK beyond Claude Code

VSCode

Settings in .vscode/settings.json:

• GitHub Copilot: Custom instructions for automated commit messages and PR descriptions
• Python: Ruff formatting with auto-save and format-on-save enabled
• Terminal: Cross-platform compatibility configurations

Statusline

Real-time usage tracking powered by ccusage.

Configuration

• .claude/settings.json - Statusline command
• .claude/ccusage.json - Locale, timezone, refresh settings

See ccusage statusline guide for setup.

TODO

• Update Supabase usage skill to include Supabase based Auth/Row Level Security/Table relationships and optimal query pattern skills instead of MCP skills
• App dokploy tools plugin with dokploy-mcp server and deployment best practices skill
• Add more comprehsensive fullstack-dev plugin with various ocnfigurable skills:
  • Frontend: Next.js 16 (App Router, React 19, TypeScript)
  • Backend: FastAPI, NodeJS
  • Auth: Clerk (Auth, Email), Firebase/Firestore (Auth, DB), Supabase+Resend (Auth, DB, Email) RBAC with org:admin and org:member roles
  • Styling: Tailwind CSS v4, shadcn/ui components, Radix UI primitives
  • Monitoring: Sentry (errors, APM, session replay, structured logs)
  • Analytics: Web Vitals + Google Analytics
• Refactor marketplace name to claude-settings to make it concise
• Publish claudesettings.com as a comprehensive documentation for installing, using and sharing useful Claude-Code settings
• Rename plugins names to mongodb-skills, github-skills ...instead of mongodb-tools, github-dev ... for better UX

References

• Claude Code - Official CLI for Claude
• Anthropic Skills - Official skill examples

Thank you for the support!