Skip to main content
Você executa comandos de plugin como claude plugin do seu shell ou script, ou como /plugin e /reload-plugins dentro de uma sessão Claude Code. Esta referência fornece as flags, padrões, saída e códigos de saída de cada comando, junto com as duas flags que carregam um plugin para uma sessão. Execute claude plugin --help em sua compilação para confirmar quais subcomandos sua versão possui.
Estes casos são cobertos em outras páginas:

​
Comandos claude plugin

Execute claude plugin <subcommand> do seu shell ou script, fora de uma sessão Claude Code. Estes subcomandos instalam e gerenciam plugins sem abrir o painel /plugin. claude plugins é um alias para claude plugin. Cada subcomando compartilha estes códigos de saída, argumentos de plugin e valores de escopo:
  • Códigos de saída: 0 em caso de sucesso e 1 em caso de falha. validate adiciona saída 2 para um erro inesperado, e eval adiciona os códigos listados em sua seção.
  • Argumentos de plugin: um argumento <plugin> é um name de plugin ou name@marketplace. Quando dois marketplaces oferecem o mesmo nome, use a forma qualificada.
  • Escopos: --scope aceita user, project ou local, e nomeia o arquivo de configurações que o comando escreve. update também aceita managed.

​
plugin init

Crie um novo plugin em ~/.claude/skills/<name>/. Ele carrega em sua próxima sessão como <name>@skills-dir sem etapa de instalação. new é um alias para init. Para o fluxo de trabalho criar, testar e editar que começa com este comando, veja Criar um plugin.
<name> se torna o nome do diretório sob ~/.claude/skills/ e o name do plugin em seu manifesto. O comando não possui flag para outro local. Para criar um scaffold dentro de um projeto, veja Criar um plugin. Criar um plugin com arquivos de skill e hook iniciais:
Claude Code valida o que foi escrito e imprime Created plugin "my-helper" at ~/.claude/skills/my-helper, seguido pelo id que ele carrega como e o comando claude plugin disable que o desativa. Claude Code sai com 1 sem escrever quando não consegue criar um scaffold com segurança, e a mensagem nomeia o motivo. Estes são motivos comuns:
  • Um valor desconhecido em --with
  • Um scaffold existente no destino sem --force
  • Uma configuração gerenciada que bloqueia plugins de diretório de skills

​
plugin install

Instale um plugin de um marketplace que você adicionou. i é um alias para install.
A maioria dos plugins é instalada sem um prompt. Para um plugin cujo marketplace executa um comando para instalá-lo ou define um headersHelper para seu download, Claude Code primeiro imprime o comando e pergunta Run this command now? [y/N]. Passe -y do seu próprio terminal para aceitar o comando exibido sem o prompt. Aqui está o que acontece sem um TTY e quando Claude executa o comando:
  • stdin ou stdout não é um TTY, e você não passa -y nem --accept-command: a instalação é recusada. A saída diz que o comando foi apenas exibido, e o código de saída é 1
  • Claude executa o comando através de sua ferramenta Bash: -y é ignorado. Execute o comando do seu próprio terminal
Instale um plugin para todos que clonam o projeto:
Claude Code imprime Successfully installed plugin: formatter@my-marketplace (scope: project). Quando nada novo é instalado, a saída diz por quê:
  • Já instalado nesse escopo: a saída é Plugin "formatter@my-marketplace" is already installed (scope: project) e o código de saída é 0
  • Você recusa um prompt de origem de comando: a saída é Aborted. e o código de saída é 1
  • Você recusa um prompt headersHelper, ou não pode ser confirmado sem um TTY: a saída é Aborted — the command was not run. e o código de saída é 1

​
Formato de resultado JSON

Quando você passa --json para plugin install, a última linha de stdout é um objeto JSON. Analise apenas essa linha, porque Claude Code imprime qualquer comando que o marketplace declara antes dela. Três campos estão sempre presentes:
  • command: o subcomando que foi executado, como install
  • outcome: ok ou failed
  • message: uma descrição legível por humanos do resultado
Outros campos, como pluginId, scope e failureCode, aparecem apenas quando se aplicam. A opção --json em plugin uninstall, plugin update, plugin enable e plugin disable imprime o mesmo objeto com os próprios campos desse subcomando. Um erro de uso, como um --scope inválido, não imprime nenhuma linha de resultado e sai com 1 com o motivo em stderr.

​
Aceitar um comando de instalação exibido

Quando uma execução --json exibe um comando declarado pelo marketplace e não o executa, o resultado failed também carrega um objeto shownCommand. Seus campos incluem o comando conforme exibido, o plugin ao qual pertence e o sha256 do comando. Para aceitar exatamente esse comando, execute novamente com esse sha256 como --accept-command do seu próprio terminal, porque a flag não tem efeito dentro de uma sessão Claude Code. Requer Claude Code v2.1.271 ou posterior. O sha256 conta como aceitação para exatamente esse comando, plugin e catálogo de marketplace. Se qualquer um deles mudou desde que o comando foi exibido, Claude Code não aceita o sha256 e mostra o comando novamente. Uma mudança que a atualização do marketplace da própria execução busca também conta como tal mudança. Se shownCommand.acceptCommandMatched for false, o sha256 que você passou não corresponde ao comando agora exibido. Revise esse comando antes de executar novamente com seu sha256.

​
plugin uninstall

Remova um plugin instalado de um escopo. remove e rm são aliases para uninstall.
Desinstale um plugin do escopo do projeto:
Claude Code imprime Successfully uninstalled plugin: formatter (scope: project). Quando o plugin não está instalado nesse escopo, o comando imprime uma linha que começa com Failed to uninstall plugin "formatter@my-marketplace": e sai com 1.

​
plugin enable

Ative um plugin desativado. Para um plugin sincronizado de claude.ai, passe <name>@synced como o plugin.
Sem --scope, o comando verifica seus arquivos de configurações na ordem local, projeto, usuário, e usa o primeiro escopo que menciona o plugin. Se você passar um --scope onde o plugin não está declarado, o comando escreve uma substituição ou falha:
  • Um escopo que tem precedência sobre o que o declara: Claude Code escreve uma substituição no escopo que você passou. Por exemplo, claude plugin disable formatter --scope local desativa um plugin ativado no projeto apenas para você
  • Qualquer outro escopo: o comando falha com Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.
Se o plugin já está ativado no escopo resolvido, o comando imprime Plugin "formatter" is already enabled e sai com 1. Com --json, o resultado tem "failureCode": "already_in_goal_state" e "alreadyInGoalState": true, então um script pode tratar esse caso como sucesso. Quando o plugin declara dependências, Claude Code as ativa também. O comando falha nestes casos:
  • Uma dependência não está instalada: a ativação falha e imprime o comando claude plugin install para cada dependência ausente
  • Uma dependência é bloqueada pela política de plugin da sua organização: a ativação falha e nomeia a dependência bloqueada
  • Uma dependência é definida como false em um escopo com precedência maior que o escopo de destino: a ativação falha. Ative a dependência nesse escopo, ou passe --scope para escrever lá
Reative um plugin onde quer que seja declarado:
Claude Code imprime Successfully enabled plugin: formatter (scope: project), nomeando o escopo que detectou.

​
plugin disable

Desative um plugin sem desinstalá-lo. Para um plugin sincronizado de claude.ai, passe <name>@synced como o plugin.
Sem --scope, o escopo é auto-detectado na mesma ordem local, projeto, usuário que plugin enable. Se você não passar nem um nome de plugin nem --all, Claude Code imprime Please specify a plugin name or use --all to disable all plugins e sai com 1. Desativar um plugin que já está desativado imprime Plugin "formatter" is already disabled e sai com 1, como plugin enable faz para um plugin já ativado. O comando falha para um plugin que ainda é necessário:
  • Outro plugin ativado depende dele: o comando falha e nomeia os dependentes para desativar primeiro
  • Sua organização o requer como um plugin sincronizado: o comando falha e não salva nada
Desative um plugin:
Claude Code imprime Successfully disabled plugin: formatter (scope: project).

​
plugin update

Atualize um plugin para a versão mais recente que seu marketplace oferece. A nova versão carrega em sua próxima sessão, ou depois que você executa /reload-plugins em uma em execução.
managed é o único escopo que você pode atualizar mas não instalar. Para plugins instalados por admin, veja Gerenciar plugins para sua organização. Atualize um plugin:
Claude Code imprime Checking for updates for plugin "formatter@my-marketplace"…, depois o resultado. Quando nada é mais recente, imprime formatter is already at the latest version (1.0.0). e sai com 0. Você pode passar um nome de plugin simples, que o comando corresponde contra seus plugins instalados. Quando plugins instalados de diferentes marketplaces compartilham o nome, o comando recusa a atualização e lista os comandos plugin-name@marketplace-name qualificados para executar. Atualizar por nome simples requer Claude Code v2.1.246 ou posterior.

​
plugin list

Liste plugins instalados com sua versão, escopo e status.
Claude Code agrupa a saída legível por humanos por como cada plugin carrega:
  • Installed plugins:: plugins que você instalou de um marketplace
  • Session-only plugins (--plugin-dir / --plugin-url):: plugins carregados por essas flags no mesmo comando, como em claude --plugin-dir ./my-plugin plugin list
  • Skills-directory plugins (.claude/skills/*):: plugins que Claude Code encontrou em um diretório de skills
  • Synced from claude.ai: plugins sincronizados de sua conta claude.ai
Sem nada em nenhum grupo, Claude Code imprime No plugins installed. Use `claude plugin install` to install a plugin.

​
Saída JSON

Com --json, Claude Code imprime um array com um objeto por instalação. Cada objeto carrega os campos abaixo. id, version, scope, enabled e installPath estão sempre presentes, e os outros aparecem apenas quando se aplicam. Com --json --available, Claude Code imprime um objeto em vez de um array. Seu campo installed contém o array de objetos de plugin instalado, e seu campo available contém um objeto por plugin de marketplace não instalado com os campos abaixo.

​
plugin details

Mostre o inventário de componentes de um plugin e seu custo de token projetado. O plugin deve estar carregado: instalado, encontrado em um diretório de skills, ou passado com --plugin-dir ou --plugin-url no mesmo comando. O <name> é um name de plugin ou name@marketplace.
O comando não toma flags além de --help. Mostre o que um plugin instalado contribui:
Claude Code imprime o nome, versão, descrição e fonte do plugin, depois estas seções:
  • Component inventory: os skills, agents, hooks, servidores MCP e servidores LSP do plugin
  • Projected token cost: os tokens sempre ativados que o plugin adiciona a cada sessão
  • Per-component (rounded): estimativas sempre ativadas e sob invocação para cada skill, agent e comando. Omitido quando o plugin não tem nenhum
Para o que as duas figuras de custo significam, veja Medir custo e uso de plugin. Para um plugin que não está carregado, Claude Code imprime Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. e sai com 1.

​
plugin prune

Remova dependências auto-instaladas que nenhum plugin instalado precisa mais. O comando nunca remove um plugin que você instalou você mesmo. autoremove é um alias para prune.
Visualize o que um prune removeria:
Claude Code lista as dependências órfãs e termina com (dry run — nothing removed). Sem nada para remover, imprime uma linha que começa com Nothing to prune. Sem --dry-run, o comando remove as dependências órfãs apenas depois que você confirma no prompt ou passa -y. O código de saída é 0 qualquer que seja sua resposta no prompt. O que prune faz depende se um terminal está anexado e se você passa -y:

​
plugin eval

Execute casos de eval de um plugin e relate resultados pontuados. Requer Claude Code v2.1.269 ou posterior. Cada caso é um prompt mais avaliadores. Claude Code o executa várias vezes em uma sessão isolada com apenas o plugin de destino carregado, e por padrão também sem o plugin para que o relatório mostre a diferença. Veja Testar plugins com evals para o formato de caso, avaliadores, resultados e uso de CI.
O target opcional padrão é o diretório atual e toma qualquer uma destas formas:
  • Um diretório de plugin
  • Um único arquivo prompt.md ou case.yaml
  • Um plugin instalado como name ou name@marketplace
  • name@skills-dir
Coloque o target antes de --tag, --allow-tools e --json. Cada uma dessas opções toma as palavras que a seguem como seu valor, então um target escrito após uma delas é lido como uma tag, um nome de ferramenta ou o caminho de saída JSON em vez de como o target. Esta tabela lista as opções que a maioria das execuções usa. Execute claude plugin eval --help para o conjunto completo, incluindo --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp e --verbose. O código de saída relata como a execução terminou. Para agir sobre ele em um pipeline, veja Executar evals em CI.

​
plugin eval init

Crie um conjunto de eval para o plugin no diretório atual. Requer Claude Code v2.1.269 ou posterior. Veja Criar seu primeiro conjunto de eval.
Em um terminal, o comando abre uma sessão Claude Code interativa para uma entrevista de autoria. Na entrevista, Claude faz o seguinte:
  1. Lê o plugin
  2. Pergunta o que ele deveria fazer bem
  3. Propõe casos e avaliadores
  4. Escreve os arquivos de caso
  5. Executa os casos e revisa as notas com você para verificar que os avaliadores pontuam da forma que você faria
Com --bare, ou sem um terminal, o comando escreve um modelo de caso único em branco. Quando Claude executa o comando de dentro de uma sessão Claude Code, o comando imprime as instruções da entrevista para essa sessão seguir em vez de escrever um modelo. O name opcional é um nome de caso. É necessário com --bare ou sem um terminal, porque o comando escreve o modelo em branco para esse caso. A entrevista não precisa de um. O comando aceita estas opções:

​
plugin tag

Crie uma tag git anotada nomeada <name>--v<version> para uma versão de plugin. Antes de marcar, o comando verifica se o plugin.json do plugin e qualquer entrada de marketplace que o liste concordam sobre a versão. Para quando marcar uma versão, veja Publicar um plugin.
O [path] é o diretório do plugin, padronizando para o diretório atual. O comando encontra a entrada do marketplace caminhando para cima a partir desse diretório para um .claude-plugin/marketplace.json que lista o plugin. Visualize a tag para um plugin em um checkout de marketplace:
Claude Code imprime o plano:
  • O nome do plugin
  • A versão e qual arquivo ela veio
  • A entrada de marketplace correspondente, quando há uma
  • O nome da tag
  • Os comandos git tag e git push que executaria
Sem --dry-run, Claude Code imprime Created tag formatter--v1.0.0 e Pushed to origin ou o comando push para você executar você mesmo. Se o push falhar, a tag ainda é criada localmente e o comando sai com um erro. O comando sai com 1 e imprime o motivo quando não consegue marcar com segurança. Motivos comuns são:
  • Sem version em plugin.json ou na entrada do marketplace
  • A tag já existe
  • A árvore de trabalho está suja

​
plugin validate

Valide um manifesto de plugin, um manifesto de marketplace, ou os skills, agents e comandos em um diretório, e saia com um código que um trabalho de CI pode agir. Para o fluxo de trabalho criar, testar e editar, veja Criar um plugin. Para o que o validador verifica em cada manifesto, veja a referência de manifesto de plugin e a referência de marketplace.
Valide um plugin antes de fazer commit:

​
Validar um diretório

O <path> é um arquivo de manifesto ou um diretório. Dado um diretório, Claude Code escolhe o que validar pelo que encontra lá:
  • .claude-plugin/marketplace.json, quando existe
  • Caso contrário .claude-plugin/plugin.json
  • Caso contrário os arquivos de componente, escolhidos pelo nome do diretório. Validar arquivos de componente sem um manifesto requer Claude Code v2.1.233 ou posterior:
    • Um diretório nomeado skills, agents ou commands: os arquivos dentro dele
    • Um diretório nomeado .claude: os diretórios skills, agents e commands dentro dele
    • Qualquer outro diretório: esses três diretórios sob seu .claude
Claude Code não segue symlinks dentro do diretório que você nomeia. O que faz depende de onde o link está:
  • Um diretório skills, agents ou commands vinculado sob a raiz do plugin ou .claude: Claude Code avisa que nada nele foi lido.
  • Uma entrada vinculada dentro de um diretório skills, agents ou commands: Claude Code a pula e avisa, por diretório, quantas entradas pulou que uma sessão carregaria.
  • O diretório skills, agents ou commands que você nomeia é ele mesmo um symlink, ou seu diretório pai .claude é: Claude Code relata um erro e não verifica nada nele. Nomeie o diretório real.
Alguns arquivos não são lidos por uma execução de validação:
  • Um SKILL.md na raiz do plugin: quando você executa claude plugin validate contra um diretório de plugin, Claude Code não verifica um SKILL.md na raiz do plugin
  • Um CLAUDE.md na raiz do plugin: em uma execução de plugin, Claude Code também avisa sobre um CLAUDE.md na raiz do plugin
  • Arquivos de plugin em uma execução de marketplace: de um diretório de marketplace, Claude Code não abre os arquivos de skill, agent, comando ou hook dos plugins. Para encontrar erros nesses arquivos, valide cada diretório de plugin

​
Saída e códigos de saída

Claude Code imprime o arquivo que validou, quaisquer erros e avisos com seus caminhos, e uma linha de veredicto. O código de saída segue o veredicto: Com --json, Claude Code escreve o relatório para stdout como um objeto JSON com estes campos de nível superior:
  • success: o mesmo veredicto que o código de saída fornece
  • strict: se a execução tratou avisos como erros
  • target: o caminho resolvido que Claude Code validou
  • manifest: o resultado do próprio manifesto, ou null para uma execução sem manifesto
  • contents: resultados por arquivo, cada um nomeando seu file e carregando arrays errors, warnings e notes
Na saída 2, o comando não escreve nada para stdout. A mensagem de erro vai para stderr.

​
Comandos claude plugin marketplace

Execute claude plugin marketplace <subcommand> do seu shell para adicionar, listar, atualizar e remover os marketplaces dos quais você instala plugins. Para o que é um marketplace e como Claude Code o armazena em cache, veja Referência de carregamento de plugin.

​
plugin marketplace add

Adicione um marketplace de um repositório GitHub, uma URL git, um marketplace.json hospedado ou um caminho local, e declare-o em um arquivo de configurações. Depois de adicioná-lo, Claude Code instala quaisquer dependências que seus plugins instalados estavam perdendo.
<source> toma qualquer uma das formas na tabela abaixo, e sua forma decide o tipo de fonte e como Claude Code busca o marketplace. Para o objeto de fonte resultante, veja a referência de marketplace. Para um host cujas URLs de clone não carregam o sufixo .git, como AWS CodeCommit, adicione o marketplace como uma entrada git em extraKnownMarketplaces. Claude Code clona uma entrada git independentemente de sua URL terminar em .git. Claude Code também clona uma URL gitlab.com com subgrupos aninhados, como https://gitlab.com/group/subgroup/project. Adicione um marketplace e compartilhe-o com o projeto:
Claude Code imprime Successfully added marketplace: your-marketplace (declared in project settings), usando o name do próprio manifesto do marketplace. Uma adição repetida ou uma fonte inválida imprime um destes resultados:
  • Marketplace já no disco: a saída é Marketplace 'your-marketplace' already on disk — declared in project settings e o código de saída é 0
  • Fonte não reconhecida: a saída é Invalid marketplace source format. Try: owner/repo, https://..., or ./path e o código de saída é 1
  • Host simples como gitlab.example.com/team/plugins: a adição falha como um atalho owner/repo inválido, e a mensagem diz para adicionar https:// ou usar um caminho local
Adicione um marketplace hospedado em claude.ai pelo nome impresso na seção From claude.ai: de claude plugin marketplace list:
Com --claudeai, o comando recusa --scope e --sparse. O marketplace é hospedado para sua conta, não declarado em um arquivo de configurações, então você não pode compartilhá-lo através do .claude/settings.json de um projeto.

​
plugin marketplace list

Liste cada marketplace que você adicionou, com sua fonte.
Claude Code imprime Configured marketplaces: e uma linha Source: por marketplace, ou No marketplaces configured. Com --json, Claude Code imprime um array com um objeto por marketplace, carregando os campos abaixo. Cada campo é uma string. Um marketplace claude.ai adicionado não tem clone local, então sua entrada carrega seus identificadores claude.ai, marketplaceId e organizationUuid, no lugar de installLocation. Também carrega scope quando um é registrado, e status. Se suas sessões de terminal sincronizam plugins de sua conta claude.ai, a listagem de texto termina com uma seção From claude.ai:. Essa seção nomeia os marketplaces que claude.ai lista para sua conta que você não adicionou, tanto baseados em git quanto hospedados. Requer Claude Code v2.1.273 ou posterior. Para adicionar um marketplace dessa seção, veja Adicionar um marketplace de claude.ai. A saída --json cobre apenas marketplaces configurados e deixa a seção de fora.

​
plugin marketplace remove

Remova a declaração de um marketplace de suas configurações. rm é um alias para remove.
Quando você remove um marketplace do último escopo que o declara, Claude Code também exclui seu cache e desinstala cada plugin que você instalou dele. Sem --scope, o comando remove a declaração de cada escopo. Para atualizar um marketplace sem perder seus plugins, execute plugin marketplace update.
O <name> é o nome do marketplace que plugin marketplace list mostra, não a fonte que você passou para add. Remova um marketplace de cada escopo:
Claude Code imprime Successfully removed marketplace: your-marketplace, adicionando (from project settings) quando você o escopo. Se você escopar para um arquivo de configurações que não declara o marketplace, o comando falha com Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.

​
plugin marketplace update

Atualize um marketplace, ou cada marketplace, de sua fonte para buscar novos plugins e versões. Um marketplace adicionado com um branch ou tag ref atualiza para o commit mais recente desse ref, não o branch padrão do repositório.
O comando não toma flags além de --help. Atualize um marketplace:
Claude Code imprime Successfully updated marketplace: your-marketplace. Quando você omite o nome, imprime uma contagem como Successfully updated 2 marketplaces. Sem marketplaces adicionados, imprime No marketplaces configured e sai com 0.

​
/plugin em uma sessão

Dentro de uma sessão interativa, /plugin abre o painel de plugin. Cada subcomando abre o painel em uma aba, executa uma ação lá ou imprime um resultado inline. /plugins e /marketplace são aliases para /plugin. Você pode executar estes comandos apenas em uma sessão de terminal interativa. Em uma execução não interativa como claude -p, Claude Code responde que /plugin não está disponível neste ambiente. Para quais superfícies têm /plugin, como instalar sem ele e o que cada aba do painel mostra, veja Instalar e gerenciar plugins. Um <plugin> é um name de plugin ou name@marketplace. A tabela abaixo lista cada forma de sessão. Os subcomandos de shell init, update, details, prune, eval e eval init não têm forma de sessão. Se você nomear um plugin que não está instalado no projeto atual em /plugin enable, disable, uninstall ou configure, Claude Code imprime Plugin "<plugin>" is not installed in this project em vez de agir.

​
/reload-plugins

Aplique mudanças de plugin pendentes à sessão em execução sem reiniciá-la. Mudanças pendentes são plugins que você instalou, atualizou, ativou, desativou ou editou no disco desde que a sessão começou. Quando você fecha o painel /plugin com mudanças pendentes que você fez nele, Claude Code executa /reload-plugins para você. Execute-o você mesmo após mudanças de plugin que acontecem fora do painel, como um comando claude plugin que você executou em outro terminal.

​
Resumo de recarregamento

Claude Code recarrega cada plugin ativo e imprime uma linha de resumo, Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers, omitindo a contagem de servidor MCP de plugin em uma sessão sem terminal interativo. Quando qualquer plugin falhou, o resumo adiciona N errors during load. Run /plugin for details. A contagem de skills cobre cada skill que um plugin fornece, tanto suas entradas commands/ quanto suas skills SKILL.md. A contagem de agents é o número de agents carregados na sessão, incluindo aqueles que não vêm de plugins. Quando as dependências de um plugin recarregado estão faltando, Claude Code as instala, recarrega novamente e anexa (+ N dependencies: <names>) resolved ao resumo.

​
Recarregamentos que mudam ferramentas MCP

Quando o recarregamento adicionaria ou removeria um servidor MCP de plugin ou a ferramenta LSP, e essa mudança invalidaria o cache de prompt, Claude Code não aplica o recarregamento. Imprime uma linha como This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply. Passe --force para aplicá-lo mesmo assim.

​
Sessões sem terminal interativo

/reload-plugins também é executado em sessões sem terminal interativo, como o aplicativo desktop, o Agent SDK e modo não interativo com -p. Requer Claude Code v2.1.260 ou posterior. Nessas sessões, o comando é executado apenas quando você o digita na sessão você mesmo, como no prompt -p ou na caixa de prompt do aplicativo desktop. Quando chega de outra forma, como através de Remote Control ou uma mensagem retransmitida do Slack, o comando responde /reload-plugins isn't available over a remote connection in this session. e não recarrega nada. O recarregamento nessas sessões não conecta ou desconecta servidores MCP de plugin. Essas mudanças entram em vigor em sua próxima sessão.

​
Flags que carregam um plugin para uma sessão

Duas flags claude carregam um plugin para uma sessão apenas, sem instalá-lo. Ambas são repetíveis. Autores de plugin as usam para testar um plugin antes de publicar. Para o fluxo de trabalho carregar-editar-recarregar, veja Desenvolver sem um marketplace. Um plugin que qualquer uma dessas flags carrega é um plugin de sessão única. claude plugin list o mostra como <name>@inline com escopo session, mas apenas quando a mesma flag precede o subcomando. Por exemplo, execute claude --plugin-dir ./my-plugin plugin list. Quando um plugin de sessão única compartilha um nome com um plugin instalado, Claude Code carrega a cópia de sessão única para essa sessão e pula a instalada. A cópia instalada carrega em vez disso se você desativou a cópia de sessão única com claude plugin disable <name>@inline, ou se configurações gerenciadas bloqueiam esse nome de plugin. Para a precedência, veja Referência de carregamento de plugin. Um administrador pode rejeitar ambas as flags e pastas nomeadas na variável CLAUDE_CODE_PLUGIN_DIRS, com a configuração gerenciada disableSideloadFlags. Claude Code então imprime que a flag é desativada pelas configurações gerenciadas de sua organização e sai com 1 sem iniciar. Do Agent SDK, a opção plugins é o equivalente de --plugin-dir.

​
Próximos passos