Encerramento do iFlow CLI: o que ainda funciona e para onde migrar

O serviço próprio do iFlow CLI foi encerrado em 17 de abril de 2026, mas o cliente não: o próprio FAQ do iFlow diz que uma cópia instalada continua funcionando por meio de uma API personalizada, e o npm ainda disponibiliza @iflow-ai/iflow-cli 0.5.19, publicado em 25 de abril de 2026 — oito dias após o encerramento anunciado — sem ser descontinuado. Portanto, a questão da migração não é "o que substitui uma ferramenta morta". É decidir se você manterá o agente que já tem em seu próprio endpoint ou migrará para um que ainda é mantido.

Quase todas as páginas que ainda aparecem nos resultados descrevem um serviço gratuito de modelos próprios que terminou. A própria página de marketing do fornecedor também não foi atualizada: em 21 de setembro de 2026, cli.iflow.cn exibe, em sua interface em inglês, um banner com o texto "iFlow CLI will officially shut down on April 17, 2026 (Beijing Time)" no futuro, cinco meses depois da data, na mesma página que ainda convida você a "experience the latest industry models like Kimi K2, Qwen3 Coder, GLM4.5 at zero cost" acima de um comando de instalação do Gitee que funciona. Leia essa página como um artefato, não como uma oferta. Este guia é para pessoas que já têm o iFlow CLI instalado; ele não sugere fazer cadastro agora.

O que foi encerrado e o que ainda está funcionando

Três coisas diferentes usam o nome iFlow, e apenas uma delas foi encerrada. Todos os status abaixo foram verificados em 21 de setembro de 2026.

Uma desambiguação, porque ela domina os resultados de pesquisa: o "iFlow" da SAP significa Integration Flow, um artefato BPMN do SAP Integration Suite. Ele compartilha um nome com este produto e nada mais. Nada nesta página se aplica a ele.

Qual opção se adapta a qual usuário

Todos que estão saindo estão deixando a mesma coisa — um serviço gratuito de modelos próprios — portanto todas as opções abaixo custam dinheiro que antes não existia. Essa, e não uma comparação de preços, é a mudança real.

O próprio iFlow indicou o Qoder, descrevendo-o na publicação de despedida como a plataforma de codificação agentic mais forte lançada pela Alibaba. Trate essa atribuição como uma afirmação do iFlow sobre o Qoder: as quatro páginas de docs.qoder.com consultadas para este guia não mencionam nenhuma empresa controladora, e a única entidade legal no rodapé é "© 2026 BRIGHT ZENITH PRIVATE LIMITED". A mesma publicação anunciou um benefício de migração de 300 créditos, registrado por e-mail em platform.iflow.cn/email-collect; em 21 de setembro de 2026, essa URL ainda respondia HTTP 200, mas exibia uma página com o texto "404 - Page Not Found" e, em chinês, informava que havia sido retirada do ar. Trate a oferta como histórica, não como algo que possa ser reivindicado.

Manter o iFlow CLI em seu próprio endpoint

A publicação que documenta isso, publicada em 20 de março de 2026, afirma que o iFlow CLI alterou automaticamente sua autorização em 17 de abril para aceitar apenas autorização de API compatível com OpenAI usando modelos personalizados. O fluxo interativo tem quatro etapas: escolher "OpenAI Compatible API" na tela de login e, em seguida, inserir a URL do endpoint do serviço, a chave da API e o nome do modelo. Os fluxos por arquivo e ambiente abaixo são extraídos da documentação de configurações do iFlow, lida em 21 de setembro de 2026.

# The shape iFlow's OWN documentation publishes for a custom endpoint.
# Not a Kunavo runtime test: nothing here was installed or executed.
# iFlow's worked example puts /v1 on the base URL, and not the
# /chat/completions route.
export IFLOW_baseUrl="https://api.kunavo.com/v1"
export IFLOW_apiKey="sk-kn-..."
export IFLOW_modelName="claude-sonnet-4-6"
iflow

# Every setting accepts four spellings, so all of these name the same value:
#   IFLOW_apiKey | IFLOW_API_KEY | iflow_apiKey | iflow_API_KEY

Os mesmos três valores ficam em um arquivo de configurações. O iFlow documenta a precedência como parâmetros de linha de comando, depois variáveis de ambiente, depois configurações do sistema, depois .iflow/settings.json no projeto, depois ~/.iflow/settings.json e, por fim, os padrões integrados.

{
  "selectedAuthType": "openai-compatible",
  "baseUrl": "https://api.kunavo.com/v1",
  "apiKey": "sk-kn-...",
  "modelName": "claude-sonnet-4-6"
}

Há uma armadilha nessa página. Ela documenta exatamente dois valores para selectedAuthType — iflow para a autenticação própria do fornecedor e openai-compatible para, em suas palavras, qualquer provedor de serviços de modelos que ofereça o protocolo OpenAI — e depois imprime uma linha de exemplo com uma terceira string que não corresponde a nenhum dos dois. Use o valor documentado, não o exemplo.

O iFlow publica o custo dessa opção como uma lista simples: um serviço de modelos personalizado não oferece o serviço WebSearch, não oferece o serviço WebFetch, não oferece capacidade multimodal integrada e não se beneficia da otimização de chamadas de ferramentas. O terceiro item remove discretamente a colagem de imagens com Ctrl+V anunciada pelo README. Separadamente, platform.iflow.cn/market retorna 404, portanto o marketplace com instalação em um clique aparentemente também desapareceu — um código de status observado, não uma declaração publicada.

Antes de editar qualquer coisa, copie todo o diretório ~/.iflow. Voltar à autenticação própria do fornecedor não é uma alternativa real, porque esse é o caminho que o iFlow anunciou como encerrado em 17 de abril de 2026 — portanto, o rollback honesto é instalar um segundo cliente ao lado do primeiro, não reverter a configuração. Nada disso foi testado em tempo de execução aqui: o iFlow CLI não foi executado contra o endpoint do Kunavo, e as etapas acima vêm da documentação do iFlow, não de um resultado medido.

O que o script oficial de migração move e o que deixa para trás

O iFlow anexou migrate_iflow_to_qoder.py ao seu guia de migração de 18 de março de 2026. O script em si não foi baixado nem executado aqui, mas sua tabela de mapeamento publicada é um inventário útil do que é portátil — mesmo que seu destino seja o Qwen Code, e não o Qoder.

iFlow CLI vs Qwen Code

Qwen Code é a migração mais próxima, equivalente em termos de função, e a diferença que importa é a manutenção, não os recursos. Em 21 de setembro de 2026, ele tem licença Apache-2.0, tem mais de 28.000 estrelas, recebeu um push naquele mesmo dia, disponibiliza npm 0.24.3 publicado horas antes e está no Homebrew core na versão 0.24.2. O iFlow CLI não tem fórmula no Homebrew core nem release no GitHub; seu repositório não possui tags e não publica código-fonte — apenas uma fórmula própria do Homebrew, fixada ao tarball do npm da versão 0.5.14.

Sua documentação de autenticação oferece três opções de nível superior no menu /auth: Alibaba ModelStudio, uma lista de provedores de terceiros integrados e um Custom Provider que, em suas próprias palavras, conecta manualmente um servidor local, proxy ou provedor não compatível e oferece suporte a OpenAI, Anthropic, Gemini e outros endpoints compatíveis. A configuração fica em modelProviders em ~/.qwen/settings.json, com OPENAI_API_KEY, OPENAI_BASE_URL e OPENAI_MODEL como rota de ambiente. Trata-se de uma base URL genuinamente livre, e é a única coisa que o iFlow CLI e o Qwen Code claramente têm em comum. Se o Qoder CLI oferece o mesmo é algo contestado pelas próprias páginas do Qoder; isso é abordado abaixo, sem ser resolvido aqui.

Duas correções ao que a maioria das páginas concorrentes afirma. Primeiro, o cliente Qwen Code é gratuito, mas sua inferência não é: a mesma documentação afirma que o nível gratuito de OAuth do Qwen foi descontinuado em 15 de abril de 2026 e que OAuth não é mais uma entrada selecionável no diálogo /auth, portanto tutoriais que ainda prometem um nível gratuito de OAuth descrevem algo que terminou; a documentação afirma a descontinuação sem publicar qual era a cota. Segundo, migrar para o Qwen Code não recupera por si só a pesquisa na web perdida pelo iFlow. Sua documentação de pesquisa na web marca a ferramenta integrada como "off" para provedores de terceiros, endpoints personalizados em outros hosts e modelos locais. Ela ainda pode ser direcionada a uma chave DashScope verificada separada por meio de tools.webSearch.model, e a documentação sugere, de modo geral, um provedor de pesquisa MCP — que é a mesma resposta necessária para um usuário do iFlow CLI. Consulte preços do Qwen Code e Qwen Code vs Claude Code para o lado da inferência.

Qoder CLI: o caminho aprovado é o mais restrito

A página de autenticação do Qoder CLI afirma que a autenticação é obrigatória antes de usar o Qoder e documenta dois métodos: login interativo ou um token de acesso pessoal configurado por meio de QODER_PERSONAL_ACCESS_TOKEN. Nenhum caminho documentado usa apenas uma chave de terceiros. Sua página de modelos personalizados vai além: ela diz para não configurar BYOK manualmente em settings.json, porque os provedores, modelos e campos de credenciais disponíveis são determinados pelo catálogo BYOK disponível para a conta atual. O guia do Kunavo Qoder vs Claude Code observa que uma nota de versão de 11 de setembro de 2026 teria anunciado endpoints de URL personalizados, o que aponta na direção oposta; essa contradição não foi resolvida, e esta página não afirma nenhum dos lados.

Estes são os planos individuais publicados pelo Qoder, em docs.qoder.com/account/pricing, em 21 de setembro de 2026. Teams e enterprise têm preços separados e não foram verificados.

Duas ressalvas. Os créditos do plano não são acumulados — a página afirma que eles são redefinidos para zero quando o período da assinatura termina. E a restrição do BYOK é realmente ambígua: a página de preços lista o uso da própria chave como benefício do plano Free, enquanto a página de modelos personalizados do CLI está marcada como "Available edition: Individual plan", e não foi possível estabelecer se o Free está incluído. Confirme no checkout antes de pagar por um BYOK que você talvez já tenha ou talvez não consiga obter.

Quanto custam os tokens em seu próprio endpoint

Os modelos anunciados pelo iFlow — Kimi K2, Qwen3 Coder, GLM4.5 — não estão no catálogo do Kunavo, então essa é uma mudança de modelo e também de cobrança. Os valores abaixo são cálculos ilustrativos de tokens, não custos medidos de tarefas nem um limite de cobrança. Considere uma sessão que envia 200.000 tokens de entrada não armazenados em cache e recebe 15.000 tokens de saída, às taxas atuais do catálogo do Kunavo por milhão de tokens.

Multiplique pelo número de sessões que você realiza por dia antes de tratar isso como um orçamento e observe que um loop de agente reenvia o contexto a cada turno, portanto um dia de trabalho envolve muitas sessões, não uma só. O valor do catálogo do Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a conta é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo. O recarregamento mínimo é de $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura. Consulte detalhes de cobrança.

Verifique a migração antes de confiar nela

Independentemente da opção escolhida, execute uma tarefa limitada e leia o que sua conta realmente registrou, em vez de confiar em uma configuração que apenas iniciou sem erro. O Kunavo publica uma página de configuração para o Qwen Code; essa é uma referência de configuração publicada, não um teste de compatibilidade, e o iFlow CLI não tem uma página de configuração aqui porque não foi testado em tempo de execução contra este endpoint. Comece pelo guia de integração do Qwen Code ou pelo guia de integração do Qoder e crie uma conta no Kunavo quando estiver pronto para financiar uma chave. Para uma visão mais ampla, o diretório de APIs de agentes lista o iFlow CLI entre os projetos aposentados, e API compatível com OpenAI explica o que um campo de URL base realmente solicita.

Perguntas frequentes

Verificado em 21 de setembro de 2026: as publicações de despedida e configuração do iFlow, seu README e sua documentação de configurações, os dois pacotes npm, a API do GitHub, cli.iflow.cn e seu pacote de i18n, seis respostas de platform.iflow.cn e apis.iflow.cn, o Homebrew, a documentação de autenticação e pesquisa na web do Qwen Code e quatro páginas de docs.qoder.com. Nenhum cliente foi instalado ou executado, portanto cada etapa de configuração aqui é documentação, não um resultado testado. As taxas de tokens do Kunavo vêm do catálogo atual, e todos os valores em dólares são cálculos ilustrativos.