GitHub - fcakyon/claude-codex-settings: My personal Claude Code and OpenAI Codex setup with battle-tested skills, commands, hooks, agents and MCP servers that I use daily.

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@claude-settings        # Azure MCP & Skills (40+ services)
/plugin install ccproxy-tools@claude-settings      # Use any LLM via ccproxy/LiteLLM
/plugin install claude-tools@claude-settings       # Sync CLAUDE.md + allowlist
/plugin install gcloud-tools@claude-settings       # GCloud MCP & Skills
/plugin install general-dev@claude-settings        # Code simplifier + utilities
/plugin install github-dev@claude-settings         # Git workflow + GitHub MCP
/plugin install linear-tools@claude-settings       # Linear MCP & Skills
/plugin install mongodb-tools@claude-settings      # MongoDB MCP & Skills (read-only)
/plugin install notification-tools@claude-settings # OS notifications
/plugin install paper-search-tools@claude-settings # Paper Search MCP & Skills
/plugin install playwright-tools@claude-settings   # Playwright MCP + E2E skill
/plugin install plugin-dev@claude-settings         # Plugin development toolkit
/plugin install slack-tools@claude-settings        # Slack MCP & Skills
/plugin install statusline-tools@claude-settings   # Session + 5H usage statusline
/plugin install supabase-tools@claude-settings     # Supabase MCP & Skills
/plugin install tavily-tools@claude-settings       # Tavily MCP & Skills
/plugin install ultralytics-dev@claude-settings    # 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 & E2E Testing

Browser automation with E2E testing skill and responsive design testing agent. Run /playwright-tools:setup after install. May require npx playwright install for browser binaries.

Agents:

responsive-tester - Test pages across viewport breakpoints

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

statusline-tools - Session + 5H Usage Statusline

Cross-platform statusline showing session context %, cost, and account-wide 5H usage with time until reset. Run /statusline-tools:setup after install.

Skills:

setup - Statusline configuration guide

Commands:

/statusline-tools:setup - Configure statusline

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

Simple statusline plugin that uses the official usage API to show account-wide block usage and reset time in real-time. Works for both API and subscription users.

Setup

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install statusline-tools@claude-settings
/statusline-tools:setup

Color coding:

🟢 <50% usage / <1h until reset
🟡 50-70% usage / 1-3.5h until reset
🔴 70%+ usage / >3.5h until reset

See Claude Code statusline docs for details.

TODO

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
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
Add worktree support to github-dev create-pr and commit-staged commands for easier work on multiple branches of the same repo simultaneously
Add current repo branch and worktree info into statusline-tools plugin

References

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

Name		Name	Last commit message	Last commit date
Latest commit History 188 Commits
.claude-plugin		.claude-plugin
.claude		.claude
.codex		.codex
.github		.github
.vscode		.vscode
plugins		plugins
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
INSTALL.md		INSTALL.md
LICENSE		LICENSE
README.md		README.md
context7.json		context7.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Installation

Plugins

Configuration

Statusline

TODO

References

Thank you for the support!

About

Uh oh!

Releases 13

Contributors 2

Languages

License

fcakyon/claude-codex-settings

Folders and files

Latest commit

History

Repository files navigation

Installation

Plugins

Configuration

Statusline

TODO

References

Thank you for the support!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 13

Contributors 2

Languages