Qwen Code: AI Coding Agent Documentation

Personalizando o ambiente sandbox (Docker/Podman)

Atualmente, o projeto não suporta o uso da função BUILD_SANDBOX após a instalação através do pacote npm

Para construir um sandbox personalizado, você precisa acessar os scripts de construção (scripts/build_sandbox.js) no repositório do código-fonte.
Esses scripts de construção não estão incluídos nos pacotes lançados pelo npm.
O código contém verificações de caminho fixas que rejeitam explicitamente solicitações de construção de ambientes que não sejam de código-fonte.

Se você precisar de ferramentas adicionais dentro do contêiner (por exemplo, git, python, rg), crie um Dockerfile personalizado. A operação específica é a seguinte

1. Clone primeiro o projeto qwen code, https://github.com/QwenLM/qwen-code.git

2. Certifique-se de executar a seguinte operação no diretório do repositório de código-fonte


 
# 1. Primeiro, instale as dependências do projeto
npm install
 
# 2. Construa o projeto Qwen Code
npm run build
 
# 3. Verifique se o diretório dist foi gerado
ls -la packages/cli/dist/
 
# 4. Crie um link global no diretório do pacote CLI
cd packages/cli
npm link
 
# 5. Verificação do link (agora deve apontar para o código-fonte)
which qwen
 
# Saída esperada: /xxx/xxx/.nvm/versions/node/v24.11.1/bin/qwen
 
# Ou caminhos semelhantes, mas deve ser um link simbólico
 
# 6. Para detalhes do link simbólico, você pode ver o caminho específico do código-fonte
ls -la $(dirname $(which qwen))/../lib/node_modules/@qwen-code/qwen-code
 
# Deve mostrar que este é um link simbólico apontando para seu diretório de código-fonte
 
# 7. Teste a versão do qwen
qwen -v
 
# npm link irá sobrescrever o qwen global. Para evitar não conseguir distinguir o mesmo número de versão, você pode desinstalar primeiro o CLI global
 
#### 3. Crie seu Dockerfile de sandbox no diretório raiz do seu projeto
 
- Caminho: `.qwen/sandbox.Dockerfile`
 
- Endereço da imagem oficial: https://github.com/QwenLM/qwen-code/pkgs/container/qwen-code
 
```bash
 
# Baseado na imagem oficial de sandbox do Qwen (recomenda-se especificar explicitamente a versão)
FROM ghcr.io/qwenlm/qwen-code:sha-570ec43
 
# Adicione suas ferramentas extras aqui
RUN apt-get update && apt-get install -y \
    git \
    python3 \
    ripgrep

4. Crie a primeira imagem de sandbox no diretório raiz do seu projeto


GEMINI_SANDBOX=docker BUILD_SANDBOX=1 qwen -s
 
# Verifique se a versão da ferramenta lançada em sandbox é consistente com a versão da sua imagem personalizada. Se forem consistentes, o início será bem-sucedido

Isso cria uma imagem específica para o projeto com base na imagem padrão de sandbox.

Remover link npm

Se você quiser restaurar a CLI oficial do qwen, remova o link npm


 
# Método 1: Desvincular globalmente
npm unlink -g @qwen-code/qwen-code
 
# Método 2: Remover no diretório packages/cli
cd packages/cli
npm unlink
 
# Verificação foi removida
which qwen
 
# Deve exibir "qwen not found"
 
# Reinstale a versão global se necessário
npm install -g @qwen-code/qwen-code
 
# Recuperação da verificação
which qwen
qwen --version