convez.ai
MCP ServerProdutividadeIntermediário
msiShariful

Claude Code Studio

msiShariful/claude-code-studio

Interface visual para gerenciar Claude Code sem editar JSON

Ver no GitHub
InicialPluginScore · de 0 a 100

GUI local sem telemetria para gerenciar toda a configuração do Claude Code — settings, permissões, MCP servers, plugins, hooks, agents, skills e CLAUDE.md — sem editar JSON manualmente. Oferece um painel centralizado que espelha a árvore de diretórios ~/.claude/, com escopos por workspace e preview de diffs antes de cada mudança.

Instalação

$npx convez-ai msiShariful/claude-code-studio

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
1
Saúde
57%
Último commit
há 4 meses
Versão
v1.0.0
Issues abertas
2
Contribuidores
1

Casos de uso

  • Gerenciar MCP servers e configurações do Claude Code através de interface visual
  • Editar agents, skills, hooks e CLAUDE.md com syntax highlighting e preview de mudanças
  • Alternar entre escopos Global, User e Project sem conflitos de configuração

Veredito

Ferramenta sólida que reduz a fricção de gerenciar configurações complexas do Claude Code. Essencial para quem trabalha com múltiplos MCP servers, agents e skills, trazendo segurança via backups automáticos e diffs visuais antes de aplicar mudanças.

README

A tradução para o português deste README ainda está na fila.


Why

Claude Code is configured through a scatter of JSON files across ~/.claude/ and each project — settings.json, .mcp.json, settings.local.json, managed policy, plus plugins, hooks, agents, skills, and CLAUDE.md memory. Knowing what's set, where it comes from, and how to change it safely means memorizing precedence rules and editing JSON by hand.

Claude Code Studio is a friendly front end over all of it. It reads and writes the same files the claude CLI uses, shows you a diff before every change, backs up every file it touches, and explains each concept in plain language — so you can use Claude Code to its full potential even if you've never read the docs.

Features

  • The .claude/ tree, as your navigation — the sidebar mirrors your real config directory (CLAUDE.md, .mcp.json, settings.json, agents/, skills/, hooks/, plugins/), with a status dot on everything that's set up. Click a file, edit it.
  • Scope-aware workspaces — switch between Global (everything, aggregated), User (your machine-wide ~/.claude config), and any Project (its project + local config). Every screen filters to the scope you're in, so you always know where a change lands.
  • Dashboard — a per-workspace overview of what Claude is set up with, what's missing, and quick links to fix the gaps. Detects the claude CLI and flags config-file problems.
  • A real editor — CLAUDE.md, agents, skills, keybindings, and every JSON config open in a CodeMirror editor with syntax highlighting, line numbers, and code folding.
  • Permissions & behavior — edit any setting by dotted path (model, env.FOO, permission rules) with a color diff preview before anything is written. Conflicts are detected, never silently overwritten.
  • Effective config — the merged result of every settings file, each value badged with the scope it comes from; click a value to jump straight to editing it at its source.
  • Tools & integrations (MCP) — list, add, and remove MCP servers across user/local/project scopes, with a searchable catalog of popular servers and live connection health (connected / failed).
  • Extensions (plugins) — browse and install real plugins from your marketplaces with a searchable picker, enable/disable/uninstall, expand any plugin for full details, and manage marketplaces.
  • Automation (hooks) — browse every lifecycle hook event with plain-English descriptions, see each hook's config, and jump to editing it.
  • History & backups — every write is snapshotted first; restore any earlier version with one click.

A look inside

Privacy & security

Claude Code Studio is built to be safe to run against your real configuration:

  • Local only. The server binds to 127.0.0.1 on a random port. Nothing is exposed to your network or the internet.
  • No telemetry, no accounts, no cloud. It never phones home. The only network calls are the ones you trigger (e.g. the claude CLI cloning a marketplace).
  • Per-session token. Every API call requires a token delivered through the launch URL fragment; cross-origin and mismatched-Host requests are rejected.
  • Scoped file access. The API reads and writes a fixed set of Claude config files — not arbitrary paths — so it can't be aimed at unrelated secrets on disk.
  • Safe writes. Changes prefer the claude CLI where it exists (claude mcp …, claude plugin …) and otherwise fall back to atomic, hash-guarded file edits — always backing up the previous version first.

See SECURITY.md for the full model and how to report a vulnerability.

Requirements

  • Node.js ≥ 18
  • The claude CLI is optional but recommended — Studio drives it for MCP and plugin actions and to probe connection health. Without it, those views degrade gracefully and writes fall back to safe file edits.

How it works

┌────────────┐   localhost + token    ┌──────────────────────┐
│  Browser   │ ◀────────────────────▶ │  cc-studio (Fastify) │
│  React SPA │   /#token=…            │  127.0.0.1:<random>  │
└────────────┘                        └──────────┬───────────┘
                                                 │ reads/writes the same files
                                                 │ the claude CLI uses
                                      ~/.claude/ · project/.claude/ · .mcp.json

npx cc-studio mints a session token, starts the server on a random local port, prints (and opens) a …/#token=… URL, and serves the prebuilt UI. The UI talks only to that local server; the server talks only to your local config files and the claude CLI.

Contributing

The repo is an npm-workspaces monorepo (packages/core, packages/server, packages/web), TypeScript throughout, developed test-first.

git clone https://github.com/msiShariful/claude-code-studio
cd claude-code-studio
npm install

npm test           # full suite across core, server, and web
npm run typecheck  # strict type-check all packages
npm run build      # build all three packages
npm run preview    # build and run the app locally

Issues and pull requests are welcome — see the package-level guides in each packages/*/ directory for architecture and conventions.

Notes

  • Published to npm as cc-studio (the claude-code-studio name was already taken); the product keeps its full name.
  • This is an independent, community project and is not an official Anthropic product.

License

MIT © msiShariful

Ver o original no GitHub

Bom para

Relacionados