ZCF: uma ferramenta de um clique para configurar o ambiente de desenvolvimento completo do Claude Code

O ZCF (Zero-Config Claude-Code Flow) é uma ferramenta de linha de comando cuja principal função é ajudar os desenvolvedores a configurar e usar rapidamente um ambiente de programação de IA chamado "Claude Code". Essa ferramenta oferece uma solução de um clique para os desenvolvedores que desejam escrever código com a ajuda da IA, mas não querem passar pela complexa configuração manual. Ela faz isso com um simples comando npx zcfO principal conceito de design do ZCF é a "configuração zero", que permite que os desenvolvedores iniciem a programação assistida por IA imediatamente. Além da instalação e configuração básicas, ele também integra uma variedade de sistemas avançados de fluxo de trabalho e agentes de IA, como a estrutura BMad para padronizar o processo de desenvolvimento e o roteamento CCR para gerenciar os custos de API e usar vários modelos de IA, tornando toda a experiência de programação de IA mais eficiente e personalizada.

Lista de funções

• Menu interativo:: Execução do usuário no terminalnpx zcfDepois disso, um menu de operação visual será exibido, orientando o usuário na inicialização, atualização de fluxos de trabalho, gerenciamento de APIs etc., o que é ideal para iniciantes.
• Inicialização com um cliqueUsuários de primeira viagem denpx zcf iO comando executa um processo de inicialização completo, incluindo a detecção e a instalação automáticas do Claude Code, a configuração de APIs, a importação de fluxos de trabalho de IA predefinidos e muito mais.
• Suporte a vários idiomasInterface de instalação: A interface de instalação da ferramenta, o arquivo de configuração e o idioma de saída da IA podem ser definidos independentemente, com suporte para chinês, inglês e outros idiomas para facilitar os desenvolvedores com hábitos de idiomas diferentes.
• Personalização do estilo de saída de IAEstilos de "persona" de IA incorporados, como "Engenheiro profissional" ou "Engenheiro gato", os usuários podem escolher estilos diferentes de acordo com suas preferências, para que as respostas da IA estejam mais alinhadas com suas preferências pessoais. O usuário pode escolher estilos diferentes de acordo com sua preferência, para que a resposta da IA esteja mais alinhada com a preferência pessoal.
• Roteamento de proxy CCRIntegra o Claude Code Router (CCR), uma poderosa ferramenta de proxy. Ela permite que os desenvolvedores encaminhem diferentes solicitações para diferentes modelos de IA e até mesmo usem alguns modelos gratuitos (como o Gemini) como uma forma de reduzir significativamente o custo de uso da API.
• Fluxo de trabalho corporativo do BMadEstrutura de agentes de IA: integra um conjunto de estruturas de agentes de IA chamado BMad. Essa estrutura simula uma equipe de desenvolvimento completa (com várias funções, como gerente de produto, arquiteto, desenvolvedor, teste, etc.) e é capaz de orientar o usuário por meio de um processo de desenvolvimento estruturado, adequado para o desenvolvimento disciplinado de projetos.
• Integração da ferramenta da barra de statusSuporte para uma ferramenta de barra de status chamada CCometixLine, que exibe o uso da API do Claude Code e o status do Git do projeto atual em tempo real na parte inferior do terminal, ajudando os desenvolvedores a acompanhar a dinâmica do projeto.
• Gerenciamento inteligente de configuraçãoDurante o processo de configuração, a ferramenta pode fazer backup automático das configurações originais do usuário e suportar a fusão das configurações antigas e novas para evitar que as configurações personalizadas do usuário sejam substituídas.
• Compatibilidade entre plataformas: Funciona em vários sistemas operacionais e ambientes, incluindo Windows, macOS, Linux e Termux em dispositivos Android.

Usando a Ajuda

O ZCF é um script Node.js executado via npm, portanto, seu uso pressupõe que você tenha um ambiente Node.js instalado em seu computador. Ele foi projetado com o objetivo de simplificar as operações, com a maior parte de sua funcionalidade disponível por meio de um único comando.

Início rápido

A maneira mais recomendada de usá-lo é por meio do menu interativo, que lista claramente todas as ações disponíveis.

1. Abra seu terminal (ferramenta de linha de comando).
2. Digite o seguinte comando e dê enter:

   npx zcf
   

3. Após a execução do comando, o terminal exibirá um menu de seleção de funções. Você pode usar as setas para cima e para baixo do teclado para selecionar a tarefa que precisa executar e, em seguida, pressionar Enter para confirmar.

   Descrição das opções de menu:

   • 1. Full initializationOpção de inicialização completa para usuários iniciantes. Ela o ajudará com todas as etapas necessárias, incluindo a instalação do Claude Code, a importação de fluxos de trabalho, a configuração de agentes de API ou CCR, a configuração de serviços MCP e muito mais. Basta selecionar essa opção e seguir as instruções passo a passo.
   • 2. Import workflowSe você já tiver o Claude Code instalado, mas quiser atualizar ou importar os arquivos de fluxo de trabalho de IA mais recentes, poderá escolher essa opção. Ela atualizará apenas as configurações relacionadas ao fluxo de trabalho e não afetará suas configurações principais, como a API.
   • 3. Configure APIAPIs: Usado para configurar APIs individualmente, como substituir uma chave de API ou configurar um proxy CCR.
   • R. CCR - Claude Code Router managementCCR: Um submenu para gerenciar o serviço do agente CCR, no qual você pode instalar, iniciar ou parar o serviço CCR.
   • L. CCometixLineBarra de status: Um submenu para gerenciar as ferramentas da barra de status do CCometixLine.
   • +. Check updatesVerifique se há novas versões de ferramentas relacionadas ao ZCF (por exemplo, Claude Code, CCR, etc.) e atualize-as.

Usando diretamente o comando

Se você já estiver familiarizado com as operações do terminal, também poderá ignorar os menus interativos e usar argumentos de comando diretamente para executar tarefas específicas, o que é mais eficiente.

1. Inicialização completa (primeiro uso)
   Se esta for sua primeira vez ou se você quiser reconfigurar tudo, execute:

   npx zcf i
   

   Esse comando é equivalente a selecionar1. Full initialization.

2. Atualizar apenas os fluxos de trabalho (atualização subsequente)
   Se você configurou seu ambiente anteriormente e agora um novo comando ou fluxo de trabalho de IA oficial foi lançado, basta atualizar esses arquivos e deixar suas próprias configurações, como APIs, inalteradas:

   npx zcf u
   

   Esse comando é equivalente a selecionar2. Import workflow.

Uso do código Claude em projetos

Depois de configurar seu ambiente por meio do ZCF, você pode começar a usá-lo em seus projetos de código.

1. No diretório raiz da pasta de seu projeto, abra um terminal.
2. Inicialização do projeto (recomendado)Quando usá-lo pela primeira vez em um projeto, é altamente recomendável executar primeiro o comando de inicialização do projeto. Esse comando permitirá que a IA analise a estrutura do seu projeto e gere umCLAUDE.mddocumentos para ajudar a IA a entender melhor o contexto do seu projeto, a qualidade das respostas subsequentes será maior.

   /init-project
   

3. Executar tarefas simplesPara tarefas pequenas e discretas, como corrigir um bug ou escrever uma função simples, você pode descrever sua tarefa diretamente para a IA:

   <在这里输入你的任务描述，例如：“修复登录页面的按钮样式问题”>
   

4. Desenvolvimento de novos recursosQuando você precisar desenvolver um novo recurso relativamente completo, use o/featComando. Ele guiará a IA por um processo mais estruturado de planejamento, seguido pelo design da interface e pela implementação do código.

   /feat <在这里输入你的功能描述，例如：“开发一个用户个人资料编辑页面”>
   

5. Implementação do fluxo de trabalho completoPara tarefas mais complexas, você pode usar o/workflowComando. Ele dividirá a tarefa em seis etapas - Pesquisar, Idealizar, Planejar, Executar, Otimizar, Revisar - e confirmará e interagirá com você em cada etapa, proporcionando-lhe o máximo de controle sobre o processo de desenvolvimento.

   /workflow <在这里输入你的复杂任务描述>
   

Modo não interativo (para scripts de automação)

O ZCF também suporta o uso em ambientes automatizados, como CI/CD. O ZCF pode ser usado em ambientes automatizados, como CI/CD, adicionando a opção--skip-prompttalvez-svocê pode ignorar todos os questionamentos interativos e passar as informações de configuração diretamente por meio de parâmetros de linha de comando.

Por exemplo, o seguinte é um exemplo completo de uma inicialização não interativa:

npx zcf i -s -g zh-CN -t api_key -k "sk-xxx" -u "https://xxx.xxx"

O significado desse comando é:

• iExecuta a inicialização.
• -sPular todos os prompts de interação.
• -g zh-CNChinês simplificado: Defina todas as configurações relacionadas ao idioma (interface, configuração, saída AI) para chinês simplificado.
• -t api_keyTipo de API: defina o tipo de API como API Key.
• -k "sk-xxx"Passe sua chave de API.
• -u "https://xxx.xxx"Passe o endereço do proxy da API.

Dessa forma, você pode integrar o ZCF aos seus scripts de implantação automatizada.

cenário do aplicativo

1. Crie rapidamente um ambiente pessoal de programação de IA
   Para desenvolvedores independentes ou pequenas equipes que desejam fazer experiências com programação assistida por IA, o ZCF oferece uma das maneiras mais rápidas de criar um ambiente de desenvolvimento totalmente funcional. Os desenvolvedores não precisam se preocupar com arquivos de configuração e scripts complicados, basta executar um único comando e, em minutos, poderão ter um assistente de programação com IA integrado a uma variedade de fluxos de trabalho eficientes.
2. Padronizar o processo de desenvolvimento assistido por IA da equipe
   Para a colaboração em equipe, o fluxo de trabalho BMad da ZCF pode ser usado para unificar as especificações de desenvolvimento. O BMad melhora a eficiência da colaboração em equipe e a qualidade do código, simulando uma equipe virtual de IA com funções de produto, desenvolvimento e teste e orientando todos os membros a seguir um processo padronizado e estruturado, desde a análise de requisitos até a implementação e o teste do código.
3. Reduzir o custo do uso de modelos de IA
   Para usuários com um alto volume de chamadas de API ou um orçamento limitado, é possível configurar o roteamento de proxy do CCR por meio do ZCF. O CCR permite que os usuários encaminhem de forma inteligente diferentes tipos de solicitações, como preenchimento de código, bate-papo, análise lógica complexa etc., para o modelo de IA mais adequado, por exemplo, deixando tarefas simples para modelos com desempenho suficiente e gratuitos, o que reduz significativamente o custo do faturamento da API e garante a eficiência do desenvolvimento. .
4. Script de automação e integração de CI/CD
   O modo não interativo do ZCF permite que ele seja facilmente integrado a scripts automatizados ou a processos de integração contínua/implantação contínua (CI/CD). Por exemplo, os scripts podem ser gravados para definir automaticamente as configurações padrão do Claude Code para um novo ambiente de desenvolvimento, garantindo a consistência em todos os ambientes.

QA

1. Qual é a relação entre a ZCF e o Claude Code?
   O ZCF é uma "ferramenta de configuração e gerenciamento" para o Claude Code, o ambiente principal para interagir de fato com a IA e a programação, e se concentra em simplificar o processo de instalação, configuração e atualização desse ambiente, adicionando a ele vários fluxos de trabalho e utilitários predefinidos. Você pode pensar no ZCF como um "assistente de instalação" ou "lançador".
2. É necessário ter uma chave oficial da API do Anthropic para usá-la?
   O ZCF oferece uma variedade de opções ao configurá-lo: você pode usar a chave de API oficial do Anthropic, ou pode usar um token de autenticação obtido via OAuth, etc. De forma mais flexível, você pode configurar um proxy CCR (Claude Code Router), por meio do qual você pode usar outros modelos grandes (como os modelos gratuitos do Gemini ou do DeepSeek), contornando assim a restrição de ter que usar APIs pagas. Gemini ou o modelo gratuito do DeepSeek), contornando assim a restrição de ter que usar a API oficial paga.
3. Quais sistemas operacionais são compatíveis com essa ferramenta?
   O ZCF tem excelente compatibilidade entre plataformas, e a documentação oficial afirma claramente que ele é compatível com os três principais sistemas operacionais de desktop: Windows, macOS e Linux. Além disso, ele foi especialmente adaptado para usar o Termux, um emulador de terminal, em dispositivos Android para garantir uma experiência totalmente funcional em dispositivos móveis.
4. A atualização do ZCF ou do Workflow substituirá minha configuração pessoal?
   Não. O ZCF foi projetado tendo em mente a retenção da configuração do usuário. Quando você executa um comando de atualização (como npx zcf uO ZCF faz o backup inteligente dos arquivos de configuração existentes (por exemplo, chaves de API, configurações de modelo etc.) e grava uma nova configuração quando você faz uma inicialização completa (ou uma reinicialização completa). Ele também oferece a opção "Merge Configuration", que permite tentar mesclar as configurações antigas e novas para maximizar a retenção de suas configurações personalizadas.