Qwen Code

Fornecedor: Alibaba Cloud Nome de instalação: qwen-code Status: Beta Configuração nativa: ~/.qwen/

InstalaçãoCopy Anchor Link

apothem install --harness qwen-code

O adaptador grava as configurações do Qwen Code, instala uma âncora de contexto QWEN.md, registra os despachantes de hook do Apothem, converte os comandos do Apothem em arquivos de comando Markdown do Qwen, instala as skills como diretórios SKILL.md e adapta as definições de auxiliares como subagentes do Qwen.

Arquivos gravados:

~/.qwen/settings.json
~/.qwen/QWEN.md
~/.qwen/apothem/rules/00-apothem-profile.md
~/.qwen/commands/
~/.qwen/skills/
~/.qwen/agents/
~/.qwen/.apothem/support/{rules,templates,hooks}/

O arquivo ~/.qwen/apothem/rules/00-apothem-profile.md é o documento de perfil. Ele carrega a sua identidade e as suas preferências do perfil compartilhado.

Mapeamento do perfil para a configuração nativaCopy Anchor Link

O adaptador renderiza as chaves documentadas de settings.json para contexto e hooks, grava QWEN.md e distribui os comandos, as skills e as definições de auxiliares do Apothem pelos diretórios de descoberta nativos do Qwen Code. As regras, os templates e o material-fonte dos hooks permanecem como material de suporte sob ~/.qwen/.apothem/support/.

Notas de compatibilidadeCopy Anchor Link

~/.qwen/.apothem/support/ é material de suporte referenciado por QWEN.md e pelos comandos de hook das configurações; não é um namespace de descoberta de propriedade do fornecedor. O bloco do Apothem em QWEN.md termina com uma seção de arquivos de suporte do Apothem que nomeia o diretório absoluto sob ~/.qwen/.apothem/support/ em relação ao qual cada citação no estilo do repositório (rules/<name>.md, templates/..., hooks/...) é resolvida.

Listas de ferramentas das skills. O Qwen Code lê a lista de ferramentas permitidas de uma skill a partir da chave de frontmatter allowedTools, em camelCase, e o valor deve ser uma lista YAML. Ele ignora a chave hifenizada allowed-tools gravada para outros agentes. Por isso, as skills instaladas trazem allowedTools como uma lista, uma entrada por linha, no lugar da string allowed-tools separada por vírgulas do corpus de origem. Cada entrada mantém a grafia da origem, incluindo padrões como Bash(git status *). Todas as outras chaves da skill, e o corpo da skill, são instalados sem alteração.

Pastas de skills. O adaptador grava as skills em ~/.qwen/skills/. O Qwen Code também lê ~/.agents/skills/ e, dentro de um projeto, .qwen/skills/ e .agents/skills/. Quando duas pastas contêm uma skill com o mesmo nome, a que está sob .qwen prevalece, então uma skill do Apothem em ~/.qwen/skills/ tem precedência sobre uma skill de mesmo nome que outro adaptador gravou em ~/.agents/skills/.

Eventos de hook. O adaptador conecta SessionStart, PreToolUse, PreCompact, PostCompact e Stop. O Qwen Code define 22 eventos de hook, e cada um destes cinco é um deles. Três dos 22 (SessionDelete, TodoCreated e TodoCompleted) não têm evento do Claude Code com o mesmo nome (o Claude Code chama os eventos de todo de TaskCreated e TaskCompleted); o adaptador não conecta nenhum deles.

VerificaçãoCopy Anchor Link

apothem verify --harness qwen-code

O comando verify confirma que:

1. A configuração nativa existe no caminho esperado.
2. Cada destino gerenciado existe; os arquivos gerenciados não estão vazios, e as configurações JSON ou YAML podem ser analisadas. Adicione --profile PATH para também confirmar que os arquivos instalados correspondem a esse perfil.
3. A rotina de verificação específica do adaptador informa sucesso.

AtualizaçãoCopy Anchor Link

apothem update --harness qwen-code

Atualiza settings.json, QWEN.md, os comandos nativos, as skills, os subagentes e a árvore de suporte do Apothem.

DesinstalaçãoCopy Anchor Link

apothem uninstall --harness qwen-code

Remove as entradas que o adaptador adicionou a ~/.qwen/settings.json (as suas próprias chaves, os servidores MCP e os manipuladores de hook permanecem, e o arquivo é excluído somente quando o Apothem o criou e nada seu restou). Remove o bloco do Apothem de ~/.qwen/QWEN.md e do documento de perfil ~/.qwen/apothem/rules/00-apothem-profile.md e mantém qualquer outro texto neles; cada arquivo é excluído somente quando nada mais resta nele. Também remove os arquivos do Apothem em ~/.qwen/commands/, ~/.qwen/skills/, ~/.qwen/agents/ e ~/.qwen/.apothem/support/; os demais arquivos dessas pastas permanecem. Cada arquivo recebe backup em ~/.apothem/backups/ antes de ser alterado ou removido. O YAML do perfil compartilhado e o motor do Apothem não são afetados.

Conformity gateCopy Anchor Link

python -m apothem.conformity.gate --all .

Solução de problemasCopy Anchor Link

Ajustes de configuraçãoCopy Anchor Link

Veja tambémCopy Anchor Link

• Todos os harnesses — o catálogo completo de ferramentas suportadas
• Guia de instalação — instale o Apothem neste harness
• Referência de apothem harnesses — liste e inspecione adaptadores pela CLI