Qwen Code

벤더: Alibaba Cloud 설치 이름: qwen-code 상태: 베타 네이티브 구성: ~/.qwen/

설치Copy Anchor Link

apothem install --harness qwen-code

어댑터는 Qwen Code 설정을 작성하고, QWEN.md 컨텍스트 앵커를 설치하며, Apothem 훅 디스패처를 등록하고, Apothem 커맨드를 Qwen Markdown 커맨드 파일로 변환하며, 스킬을 SKILL.md 디렉터리로 설치하고, 도우미 정의를 Qwen 서브에이전트로 조정합니다.

작성되는 파일:

~/.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}/

파일 ~/.qwen/apothem/rules/00-apothem-profile.md는 프로필 문서입니다. 이 문서는 공유 프로필에서 가져온 여러분의 신원과 선호를 담고 있습니다.

프로필에서 네이티브 구성으로의 매핑Copy Anchor Link

어댑터는 컨텍스트와 훅을 위해 문서화된 settings.json 키를 렌더링하고, QWEN.md를 작성하며, Apothem 커맨드, 스킬, 도우미 정의를 Qwen Code의 네이티브 디스커버리 디렉터리 전반에 엮어 넣습니다. 규칙, 템플릿, 훅 소스 자료는 ~/.qwen/.apothem/support/ 아래에 지원 자료로 남습니다.

호환성 참고 사항Copy Anchor Link

~/.qwen/.apothem/support/는 QWEN.md와 설정의 훅 명령이 참조하는 지원 자료이며, 벤더 소유의 디스커버리 네임스페이스가 아닙니다. QWEN.md의 Apothem 블록은 Apothem 지원 파일 섹션으로 끝납니다. 이 섹션은 저장소 스타일의 각 인용(rules/<name>.md, templates/..., hooks/...)이 해석되는 기준인 ~/.qwen/.apothem/support/ 아래의 절대 디렉터리를 명시합니다.

스킬 도구 목록. Qwen Code는 스킬의 도구 허용 목록을 camelCase allowedTools 프런트매터 키에서 읽으며, 그 값은 YAML 목록이어야 합니다. 다른 에이전트를 위해 작성된 하이픈 표기 allowed-tools 키는 무시합니다. 따라서 설치된 스킬은 소스 코퍼스의 쉼표로 구분된 allowed-tools 문자열 대신, 한 줄에 항목 하나씩인 목록으로 allowedTools를 담습니다. 각 항목은 Bash(git status *) 같은 패턴을 포함하여 소스의 표기를 유지합니다. 다른 모든 스킬 키와 스킬 본문은 변경 없이 설치됩니다.

스킬 폴더. 어댑터는 스킬을 ~/.qwen/skills/에 작성합니다. Qwen Code는 ~/.agents/skills/도 읽고, 프로젝트 안에서는 .qwen/skills/와 .agents/skills/도 읽습니다. 두 폴더에 같은 이름의 스킬이 있으면 .qwen 아래의 스킬이 우선하므로, ~/.qwen/skills/의 Apothem 스킬은 다른 어댑터가 ~/.agents/skills/에 작성한 같은 이름의 스킬보다 우선합니다.

훅 이벤트. 어댑터는 SessionStart, PreToolUse, PreCompact, PostCompact, Stop을 연결합니다. Qwen Code는 22개의 훅 이벤트를 정의하며 이 다섯 개는 각각 그중 하나입니다. 22개 중 세 개(SessionDelete, TodoCreated, TodoCompleted)에는 같은 이름의 Claude Code 이벤트가 없습니다(Claude Code는 todo 이벤트를 TaskCreated와 TaskCompleted라고 부릅니다). 어댑터는 그중 어느 것도 연결하지 않습니다.

검증Copy Anchor Link

apothem verify --harness qwen-code

verify 명령은 다음을 확인합니다.

1. 네이티브 구성이 예상 경로에 존재합니다.
2. 각 관리 대상이 존재하고, 관리되는 파일은 비어 있지 않으며, JSON 또는 YAML 구성은 파싱됩니다. 설치된 파일이 그 프로필과도 일치하는지 확인하려면 --profile PATH를 추가하세요.
3. 어댑터별 검증 루틴이 성공을 보고합니다.

업데이트Copy Anchor Link

apothem update --harness qwen-code

settings.json, QWEN.md, 네이티브 커맨드, 스킬, 서브에이전트, 그리고 Apothem 지원 하위 트리를 새로 고칩니다.

제거Copy Anchor Link

apothem uninstall --harness qwen-code

어댑터가 ~/.qwen/settings.json에 추가한 항목을 제거합니다(여러분의 키, MCP 서버, 훅 핸들러는 그대로 남으며, 이 파일은 Apothem이 직접 만들었고 여러분의 항목이 하나도 남아 있지 않은 경우에만 삭제됩니다). ~/.qwen/QWEN.md와 프로필 문서 ~/.qwen/apothem/rules/00-apothem-profile.md에서 Apothem 블록을 제거하고 그 안의 다른 텍스트는 유지하며, 각 파일은 그 안에 다른 내용이 남아 있지 않은 경우에만 삭제됩니다. 또한 ~/.qwen/commands/, ~/.qwen/skills/, ~/.qwen/agents/, ~/.qwen/.apothem/support/에 있는 Apothem 파일을 제거하며, 그 폴더들의 다른 파일은 그대로 남습니다. 각 파일은 변경하거나 제거하기 전에 ~/.apothem/backups/ 아래에 백업됩니다. 공유 프로필 YAML과 Apothem 엔진은 영향을 받지 않습니다.

적합성 게이트Copy Anchor Link

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

문제 해결Copy Anchor Link

구성 노브Copy Anchor Link

함께 보기Copy Anchor Link

• 전체 하니스 — 지원되는 도구의 전체 카탈로그
• 설치 가이드 — 이 하니스에 Apothem 설치
• apothem harnesses 참조 — CLI에서 어댑터를 나열하고 검사