Qwen Code 설정

설정 레이어

설정은 다음 우선순위 순서로 적용됩니다(낮은 번호가 높은 번호에 의해 재정의됨):

설정 파일

Qwen Code는 영구 구성에 JSON 설정 파일을 사용합니다. 파일 위치는 네 곳입니다:

프로젝트의 .qwen 디렉토리

프로젝트 설정 파일 외에도, 프로젝트의 .qwen 디렉토리에는 Qwen Code의 작동과 관련된 기타 프로젝트별 파일을 포함할 수 있습니다:

• 사용자 정의 샌드박스 프로파일(예: .qwen/sandbox-macos-custom.sb, .qwen/sandbox.Dockerfile).
• .qwen/skills/ 아래의 Agent Skill(각 Skill은 SKILL.md를 포함하는 디렉토리).

설정 마이그레이션

Qwen Code는 레거시 설정을 새 형식으로 자동 마이그레이션합니다. 이전 설정 파일은 마이그레이션 전에 백업됩니다. 다음 설정은 부정(disable*)에서 긍정(enable*) 명칭으로 변경되었습니다:

disableAutoUpdate와 disableUpdateNag의 통합 정책

두 레거시 설정이 서로 다른 값으로 존재할 때, 마이그레이션은 다음 정책을 따릅니다: disableAutoUpdate 또는 disableUpdateNag 중 하나라도 true이면 enableAutoUpdate는 false가 됩니다:

settings.json의 사용 가능한 설정

설정은 범주로 구분됩니다. 대부분의 설정은 settings.json 파일의 해당 최상위 범주 객체 내에 배치해야 합니다. proxy와 plansDirectory 같은 일부 최상위 설정은 호환성을 위해 직접 루트 키로 유지됩니다.

general

output

ui

ide

privacy

model

model.generationConfig 예시:

{
  "model": {
    "generationConfig": {
      "timeout": 60000,
      "contextWindowSize": 128000,
      "modalities": {
        "image": true
      },
      "enableCacheControl": true,
      "toolResultContentFormat": "parts",
      "customHeaders": {
        "X-Client-Request-ID": "req-123"
      },
      "extra_body": {
        "enable_thinking": true
      },
      "samplingParams": {
        "temperature": 0.2,
        "top_p": 0.8,
        "max_tokens": 1024
      }
    }
  }
}

timeout (요청 타임아웃):

timeout은 밀리초 단위의 요청별 타임아웃(기본값 120000)입니다. 0으로 설정하면 요청 타임아웃을 비활성화합니다 — QWEN_STREAM_IDLE_TIMEOUT_MS=0 규칙과 일치 — 요청을 중단하지 않습니다. QWEN_CODE_API_TIMEOUT_MS 환경 변수로도 설정할 수 있습니다. 이는 아래의 두 스트림 가드와 구별됩니다.

스트림 가드 (OpenAI 호환 제공자 전용):

두 가드가 스트리밍 응답을 제한하며, 각각 0을 받아 비활성화합니다. Anthropic/Gemini 생성기는 구현하지 않으며, 아래의 drip-fed 형태를 제한 없이 둡니다.

• QWEN_STREAM_IDLE_TIMEOUT_MS(기본값 240000)는 스트리밍 청크 _사이_의 비활성 시간을 제한합니다: 이 시간 동안 침묵하는 스트림은 재시도 가능한 ETIMEDOUT으로 중단됩니다.
• QWEN_STREAM_MAX_LIFETIME_MS(기본값 900000)는 청크 흐름과 무관하게 하나의 스트리밍 응답의 전체 업스트림 대기 시간을 제한합니다 — 완료되지 않는 drip-fed 스트림이 리셋할 수 없는 바운드.

이것들은 환경 변수(또는 임베더의 경우 ContentGeneratorConfig.streamIdleTimeoutMs / streamMaxLifetimeMs) 전용 — settings.json 키가 없습니다; settings.json에 "streamMaxLifetimeMs"를 작성해도 효과가 없습니다. 업그레이드 노트: 이전에 QWEN_STREAM_IDLE_TIMEOUT_MS=0(또는 ContentGeneratorConfig에서 streamIdleTimeoutMs: 0)을 설정하여 스트림 중단을 옵트아웃했던 배포는 이제 QWEN_STREAM_MAX_LIFETIME_MS=0(또는 streamMaxLifetimeMs: 0)도 필요합니다. 15분 수명 캡은 유휴 타임아웃을 그 이상으로 올린 스트림도 제한합니다(예: QWEN_STREAM_IDLE_TIMEOUT_MS=1800000) — 더 긴 창에 의존한다면 캡도 동일하게 올리거나 0으로 설정하세요.

max_tokens (출력 토큰 제한):

samplingParams.max_tokens과 QWEN_CODE_MAX_OUTPUT_TOKENS가 모두 설정되지 않으면 Qwen Code는 일반적으로 선택된 모델의 선언된 출력 제한을 요청의 기본 출력 제한으로 사용합니다. 응답이 여전히 해당 제한에 도달하면 Qwen Code는 상향된 제한(64K 바닥)으로 재시도하고 연속 턴에 걸쳐 복구할 수 있습니다.

OpenAI 호환 제공자의 경우 samplingParams는 와이어 형태 이스케이프 해치이기도 합니다: 설정되면 키가 그대로 전달되며 Qwen Code는 max_tokens 기본값을 합성하지 않습니다. max_completion_tokens 같은 제공자별 파라미터에 사용하세요.

고정 출력 제한을 강제하려면 설정에서 samplingParams.max_tokens을 설정하거나 QWEN_CODE_MAX_OUTPUT_TOKENS 환경 변수를 사용하세요. 명시적 제한은 자동 출력 토큰 상향을 비활성화합니다.

toolResultContentFormat:

OpenAI 호환 요청에서 텍스트 전용 도구 결과의 직렬화 방식을 제어합니다. 기본값 "parts"는 표준 콘텐츠 파트 배열 형태를 유지합니다. "string"은 도구 템플리트가 텍스트 콘텐츠 파트를 무시하는 레거시 OpenAI 호환 런타임(예: 오래된 GLM-5.1 vLLM/SGLang 템플리트)에만 설정하세요. 도구 반환 미디어는 여전히 splitToolMedia의 영향을 받습니다.

contextWindowSize:

선택된 모델의 기본 컨텍스트 창 크기를 재정의합니다. Qwen Code는 모델 이름 패턴 매칭을 기반으로 내장 기본값을 사용하여 컨텍스트 창을 결정하며, 상수 폴백 값이 있습니다. 제공자의 유효 컨텍스트 제한이 Qwen Code의 기본값과 다를 때 이 설정을 사용하세요. 이 값은 모델의 가정된 최대 컨텍스트 용량을 정의하며, 요청별 토큰 제한이 아닙니다.

선택된 모델이 modelProviders에 정의되어 있으면 최상위 model.generationConfig 대신 해당 제공자 항목의 generationConfig에서 contextWindowSize를 설정하세요. 제공자 모델 항목은 봉인되어 있으므로 최상위 생성 설정이 누락된 제공자 필드를 채우지 않습니다.

modalities:

선택된 모델의 자동 감지된 입력 모달리티를 재정의합니다. Qwen Code는 모델 이름 패턴 매칭을 기반으로 지원되는 모달리티(image, PDF, audio, video)를 자동으로 감지합니다. 자동 감지가 올바르지 않을 때 이 설정을 사용하세요 — 예를 들어 지원하지만 인식되지 않는 모델에 대해 pdf를 활성화합니다. 형식: { "image": true, "pdf": true, "audio": true, "video": true }. 지원되지 않는 유형은 키를 생략하거나 false로 설정하세요.

customHeaders:

모든 API 요청에 사용자 정의 HTTP 헤더를 추가할 수 있습니다. 요청 추적, 모니터링, API 게이트웨이 라우팅 또는 다른 모델이 다른 헤더를 요구할 때 유용합니다. 제공자 모델의 경우 modelProviders[].generationConfig.customHeaders에 customHeaders를 정의하세요. 일치하는 제공자 항목이 없는 런타임 모델의 경우 model.generationConfig.customHeaders에 정의하세요. 두 수준 간 병합은 발생하지 않습니다.

extra_body 필드는 API로 전송되는 요청 body에 사용자 정의 파라미터를 추가할 수 있습니다. 표준 구성 필드에서 다루지 않는 제공자별 옵션에 유용합니다. 참고: 이 필드는 OpenAI 호환 제공자(openai, qwen-oauth)에서만 지원됩니다. Anthropic과 Gemini 제공자에서는 무시됩니다. 제공자 모델의 경우 modelProviders[].generationConfig.extra_body에 extra_body를 정의하세요. 일치하는 제공자 항목이 없는 런타임 모델의 경우 model.generationConfig.extra_body에 정의하세요.

model.openAILoggingDir 예시:

• "~/qwen-logs" - ~/qwen-logs 디렉토리에 로깅
• "./custom-logs" - 현재 디렉토리 기준 ./custom-logs에 로깅
• "/tmp/openai-logs" - 절대 경로 /tmp/openai-logs에 로깅

fastModel

visionModel

compactionModel

imageModel

visionBridgeTimeoutMs

voiceModel

modelFallbacks

modelPricing

context

파일 검색 성능 문제 해결

파일 검색(예: @ 완성)에서 성능 문제가 발생하면, 특히 파일 수가 매우 많은 프로젝트에서 다음 방법을 순서대로 시도해 보세요:

1. ignore 파일 사용: 프로젝트 루트에 .qwenignore 또는 구성된 사용자 정의 ignore 파일을 생성하여 참조할 필요가 없는 대량 파일이 포함된 디렉토리(예: 빌드 아티팩트, 로그, node_modules)를 제외하세요. 크롤링되는 총 파일 수를 줄이는 것이 성능을 개선하는 가장 효과적인 방법입니다.
2. 퍼지 검색 비활성화: 파일 무시만으로는 부족하면 settings.json에서 enableFuzzySearch를 false로 설정하여 퍼지 검색을 비활성화할 수 있습니다. 더 단순한 비퍼지 매칭 알고리즘을 사용하여 더 빠를 수 있습니다.
3. 재귀 파일 검색 비활성화: 마지막 수단으로 enableRecursiveFileSearch를 false로 설정하여 재귀 파일 검색을 완전히 비활성화할 수 있습니다. 프로젝트의 재귀 크롤을 피하므로 가장 빠른 옵션입니다. 단, @ 완성 사용 시 파일의 전체 경로를 입력해야 합니다.

tools

memory

자동 메모리의 작동 방식 및 /memory, /remember, /dream 명령어 사용법은 Memory를 참조하세요.

agents

permissions

권한 시스템은 어떤 도구를 실행할 수 있는지, 어떤 도구가 확인이 필요한지, 어떤 도구가 차단되는지에 대한 세밀한 제어를 제공합니다.

결정 우선순위(높은 순): deny > ask > allow > (기본값/대화형 모드)

첫 번째로 일치하는 규칙이 승리합니다. 규칙은 "ToolName" 또는 "ToolName(specifier)" 형식을 사용합니다.

도구 이름 별칭(규칙에서 모두 작동):

메타 범주:

일부 규칙 이름은 자동으로 여러 도구를 포함합니다:

[!important] Read(/path/**)는 네 가지 읽기 도구(파일 읽기, grep, glob, 디렉토리 목록)를 모두 포함합니다. 파일 읽기만 제한하려면 ReadFile(/path/**) 또는 read_file(/path/**)를 사용하세요.

규칙 구문 예시:

경로 패턴 접두사:

셸 명령 우회 방지:

Read, Edit, WebFetch의 권한 규칙은 에이전트가 동등한 셸 명령을 실행할 때도 적용됩니다.

레거시 설정에서 마이그레이션:

설정 예시:

{
  "permissions": {
    "allow": ["Bash(git *)", "Bash(npm run *)", "Read(//Users/alice/code/**)"],
    "ask": ["Bash(git push *)", "Edit"],
    "deny": ["Bash(rm -rf *)", "Read(.env)", "WebFetch(malicious.com)"]
  }
}

[!tip] 인터랙티브 CLI에서 /permissions를 사용하면 settings.json을 직접 편집하지 않고도 규칙을 보고, 추가하고, 제거할 수 있습니다.

slashCommands

CLI에서 사용 가능한 슬래시 명령어를 제어합니다. 멀티테넌트 또는 기업 배포에서 명령어 표면을 제한하는 데 유용합니다.

동일한 거부 목록은 --disabled-slash-commands CLI 플래그(쉼표로 구분 또는 반복)와 QWEN_DISABLED_SLASH_COMMANDS 환경 변수를 통해서도 제공될 수 있으며, 세 출처의 값이 모두 합집합됩니다.

예시 — 샌드박스 배포를 위한 내장 명령어 잠금:

{
  "slashCommands": {
    "disabled": ["auth", "mcp", "extensions", "ide", "quit"]
  }
}

시스템 수준 settings.json(/etc/qwen-code/settings.json 또는 QWEN_CODE_SYSTEM_SETTINGS_PATH)에 이러한 값이 있으면 사용자는 자체 범위에서 거부 목록을 축소할 수 없으며 비활성화된 명령어는 자동 완성에서 나타나지 않고 입력 시 실행되지 않습니다.

[!note] 이 설정은 슬래시 명령어(예: /auth, /mcp)만 게이트합니다. 도구 권한에는 영향을 주지 않습니다 — 해당 내용은 permissions.deny를 참조하세요. Ctrl+C 또는 Esc 같은 키보드 단축키도 가로채지 않습니다.

skills

모델에 노출되는 Skill을 제어합니다.

우선순위는 skills.disabled > skills.enabled > skills.defaultDisabled입니다. 예를 들어 사용자는 skill을 defaultDisabled에 넣을 수 있고 프로젝트는 동일한 이름을 enabled에 추가할 수 있습니다. 어느 범위의 하드 disabled 항목이 여전히 승리합니다.

mcp

lsp

[!warning] 실험적 기능: LSP 지원은 현재 실험적이며 기본적으로 비활성화되어 있습니다. --experimental-lsp 커맨드라인 플래그를 사용하여 활성화하세요.

Language Server Protocol(LSP)은 go-to-definition, 참조 찾기, 진단과 같은 코드 인텔리전스 기능을 제공합니다.

LSP 서버 구성은 settings.json이 아닌 프로젝트 루트 디렉토리의 .lsp.json 파일을 통해 수행됩니다. 구성 세부 정보와 예시는 LSP 문서를 참조하세요.

security

serve

qwen serve의 영구 서브 세션 동시성 설정. 변경 사항은 데몬을 재시작해야 합니다. 양수가 아니거나 정수가 아닌 동시성 제한은 경고를 생성하고 내장 기본값으로 폴백합니다.

advanced

experimental

mcpServers

사용자 정의 도구를 발견하고 사용하기 위해 하나 이상의 모델 컨텍스트 프로토콜(MCP) 서버에 대한 연결을 구성합니다. Qwen Code는 구성된 각 MCP 서버에 연결하여 사용 가능한 도구를 발견하려고 시도합니다. 여러 MCP 서버가 동일한 이름의 도구를 노출하면 도구 이름에 구성에서 정의한 서버 별칭이 접두사로 추가됩니다(예: serverAlias__actualToolName). 시스템이 호환성을 위해 MCP 도구 정의에서 특정 스키마 속성을 제거할 수 있습니다. command, url, httpUrl 중 최소 하나를 제공해야 합니다. 여러 개가 지정되면 우선순위 순서는 httpUrl, 그다음 url, 그다음 command입니다.

telemetry

Qwen Code의 로깅 및 메트릭 수집을 구성합니다. 자세한 내용은 telemetry를 참조하세요.

settings.json 예시

v0.3.0부터의 중첩 구조를 가진 settings.json 파일 예시:

{
  "proxy": "http://localhost:7890",
  "plansDirectory": "./.qwen/plans",
  "general": {
    "vimMode": true,
    "preferredEditor": "code"
  },
  "ui": {
    "theme": "GitHub",
    "hideTips": false,
    "customWittyPhrases": [
      "You forget a thousand things every day. Make sure this is one of 'em",
      "Connecting to AGI"
    ]
  },
  "tools": {
    "approvalMode": "yolo",
    "sandbox": "docker",
    "sandboxImage": "ghcr.io/qwenlm/qwen-code:0.14.1",
    "discoveryCommand": "bin/get_tools",
    "callCommand": "bin/call_tool",
    "exclude": ["write_file"]
  },
  "mcpServers": {
    "mainServer": {
      "command": "bin/mcp_server.py"
    },
    "anotherServer": {
      "command": "node",
      "args": ["mcp_server.js", "--verbose"]
    }
  },
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4317",
    "logPrompts": true,
    "userId": "user-079458",
    "includeSensitiveSpanAttributes": false,
    "sensitiveSpanAttributeMaxLength": 1048576
  },
  "privacy": {
    "usageStatisticsEnabled": true
  },
  "model": {
    "name": "qwen3-coder-plus",
    "maxSessionTurns": 10,
    "enableOpenAILogging": false,
    "openAILoggingDir": "~/qwen-logs",
  },
  "context": {
    "fileName": ["CONTEXT.md", "QWEN.md"],
    "includeDirectories": ["path/to/dir1", "~/path/to/dir2", "../path/to/dir3"],
    "loadFromIncludeDirectories": true,
    "fileFiltering": {
      "respectGitIgnore": false
    }
  },
  "advanced": {
    "excludedEnvVars": ["DEBUG", "DEBUG_MODE", "NODE_ENV"]
  }
}

셸 기록

CLI는 실행한 셸 명령의 기록을 유지합니다. 다른 프로젝트 간의 충돌을 피하기 위해 이 기록은 사용자 홈 폴더 내의 프로젝트별 디렉토리에 저장됩니다.

• 위치: ~/.qwen/tmp/<project_hash>/shell_history
  • <project_hash>는 프로젝트의 루트 경로에서 생성된 고유 식별자입니다.
  • 기록은 shell_history라는 파일에 저장됩니다.

환경 변수 및 .env 파일

환경 변수는 애플리케이션을 구성하는 일반적인 방법이며, 특히 민감한 정보(토큰 등)나 환경 간에 변경될 수 있는 설정에 사용됩니다.

Qwen Code는 .env 파일에서 환경 변수를 자동으로 로드할 수 있습니다. 인증 관련 변수(OPENAI_* 등)와 권장 .qwen/.env 접근 방식은 **Authentication**을 참조하세요.

환경 변수 표

사용자 수준 .env 파일이 동일한 변수를 정의할 때 Qwen 전용 파일이 승리합니다: <QWEN_HOME>/.env(또는 QWEN_HOME이 설정되지 않으면 ~/.qwen/.env)가 ~/.env 전에 로드되며 기존 환경 값은 덮어쓰지 않습니다.

커맨드라인 인자

CLI를 실행할 때 직접 전달되는 인자는 해당 세션에 대해 다른 구성을 재정의할 수 있습니다.

샌드박스 이미지 선택의 우선순위는 다음과 같습니다: --sandbox-image > QWEN_SANDBOX_IMAGE > tools.sandboxImage > 내장 기본 이미지.

커맨드라인 인자 표

컨텍스트 파일(계층적 지시 컨텍스트)

CLI의 _동작_에 대한 엄격한 구성은 아니지만, 컨텍스트 파일(기본적으로 QWEN.md이지만 context.fileName 설정으로 구성 가능)은 지시 컨텍스트(“메모리”라고도 함)를 구성하는 데 중요합니다. 이 강력한 기능을 사용하면 프로젝트별 지시, 코딩 스타일 가이드 또는 관련 배경 정보를 AI에게 제공하여 응답을 사용자의 요구에 더 맞고 정확하게 만들 수 있습니다. CLI는 로드된 컨텍스트 파일 수를 나타내는 footer 표시기와 같은 UI 요소를 통해 활성 컨텍스트에 대한 정보를 제공합니다.

• 목적: 이 Markdown 파일에는 Qwen 모델이 응답을 생성할 때 참조할 지시, 가이드라인 또는 컨텍스트가 포함됩니다.
• 위치: 컨텍스트 파일은 프로젝트 루트 또는 그 상위 디렉토리에 배치할 수 있습니다.

컨텍스트 파일 내용 예시(예: QWEN.md)

TypeScript 프로젝트 루트에 있는 컨텍스트 파일의 개념적 예시:

# Project: My Awesome TypeScript Library

## General Instructions:
- When generating new TypeScript code, please follow the existing coding style.
- Ensure all new functions and classes have JSDoc comments.
- Prefer functional programming paradigms where appropriate.
- All code should be compatible with TypeScript 5.0 and Node.js 22+.

## Coding Style:
- Use 2 spaces for indentation.
- Interface names should be prefixed with `I` (e.g., `IUserService`).
- Private class members should be prefixed with an underscore (`_`).
- Always use strict equality (`===` and `!==`).

## Specific Component: `src/api/client.ts`
- This file handles all outbound API requests.
- When adding new API call functions, ensure they include robust error handling and logging.
- Use the existing `fetchWithRetry` utility for all GET requests.

## Regarding Dependencies:
- Avoid introducing new external dependencies unless absolutely necessary.
- If a new dependency is required, please state the reason.

이 예시는 일반 프로젝트 컨텍스트, 특정 코딩 규칙, 특정 파일이나 컴포넌트에 대한 노트를 제공하는 방법을 보여줍니다. 컨텍스트 파일이 관련성이 있고 정확할수록 AI가 더 잘 도울 수 있습니다. 프로젝트별 컨텍스트 파일을 사용하여 규칙과 컨텍스트를 설정하는 것을 강력히 권장합니다.

• 계층적 로딩 및 우선순위: CLI는 여러 위치에서 컨텍스트 파일(예: QWEN.md)을 로드하여 계층적 메모리 시스템을 구현합니다. 이 목록의 아래(더 구체적)에 있는 파일의 내용은 위(더 일반적)에 있는 파일의 내용을 일반적으로 재정의하거나 보완합니다. 정확한 연결 순서와 최종 컨텍스트는 /memory 대화상자에서 확인할 수 있습니다. 일반적인 로딩 순서는 다음과 같습니다:
  1. 전역 컨텍스트 파일:
     • 위치: ~/.qwen/<configured-context-filename>(예: 사용자 홈 디렉토리의 ~/.qwen/QWEN.md).
     • 범위: 모든 프로젝트에 대한 기본 지시를 제공합니다.
  2. 프로젝트 루트 및 상위 컨텍스트 파일:
     • 위치: CLI는 현재 작업 디렉토리에서 구성된 컨텍스트 파일을 검색한 다음 프로젝트 루트(.git 폴더로 식별) 또는 홈 디렉토리까지 각 상위 디렉토리에서 검색합니다.
     • 범위: 전체 프로젝트 또는 그 상당 부분과 관련된 컨텍스트를 제공합니다.
• 연결 및 UI 표시: 발견된 모든 컨텍스트 파일의 내용은 구분 기호와 함께 연결(출처와 경로를 표시)되어 시스템 프롬프트의 일부로 제공됩니다. CLI footer는 로드된 컨텍스트 파일 수를 표시하여 활성 지시 컨텍스트에 대한 빠른 시각적 단서를 제공합니다.
• 내용 가져오기: @path/to/file.md 구문을 사용하여 다른 Markdown 파일을 가져옴으로써 컨텍스트 파일을 모듈화할 수 있습니다. 자세한 내용은 Memory 문서를 참조하세요.
• 메모리 관리 명령어:
  • /memory를 사용하여 메모리 관리 대화상자를 엽니다.
  • 대화상자에서 메모리를 새로 고쳐 모든 구성된 위치에서 컨텍스트 파일을 다시 검색하고 로드합니다.
  • /memory 명령어에 대한 자세한 내용은 Commands 문서를 참조하세요.

구성 레이어와 컨텍스트 파일의 계층적 특성을 이해하고 활용함으로써 AI의 메모리를 효과적으로 관리하고 Qwen Code의 응답을 특정 요구와 프로젝트에 맞게 조정할 수 있습니다.

샌드박스

Qwen Code는 시스템을 보호하기 위해 샌드박스 환경에서 잠재적으로 안전하지 않은 작업(셸 명령 및 파일 수정 등)을 실행할 수 있습니다.

샌드박스는 기본적으로 비활성화되어 있지만 다음 방법으로 활성화할 수 있습니다:

• --sandbox 또는 -s 플래그 사용.
• QWEN_SANDBOX 환경 변수 설정.
• 설정에서 tools.sandbox 설정.

⚠️ --yolo는 샌드박스를 자동으로 활성화하지 않습니다. YOLO 모드는 도구 호출만 자동 승인합니다. 샌드박싱은 --sandbox, QWEN_SANDBOX 또는 tools.sandbox를 통해 별도로 옵트인해야 합니다. --yolo(또는 --approval-mode=yolo)와 샌드박스 없이 헤드리스/비대화형 실행에서 모델은 현재 프로세스의 권한 수준에서 셸, 쓰기 및 편집 도구를 실행할 수 있습니다 — Qwen Code는 이 경우 stderr에 경고를 출력합니다. 트레이드오프를 검토한 후 QWEN_CODE_SUPPRESS_YOLO_WARNING=1로 억제하세요.

기본적으로 미리 빌드된 qwen-code-sandbox Docker 이미지를 사용합니다.

프로젝트별 샌드박싱이 필요한 경우 프로젝트 루트 디렉토리의 .qwen/sandbox.Dockerfile에 사용자 정의 Dockerfile을 생성할 수 있습니다. 이 Dockerfile은 기본 샌드박스 이미지를 기반으로 할 수 있습니다:

FROM qwen-code-sandbox
# 여기에 사용자 정의 종속성이나 구성을 추가하세요
# 예:
# RUN apt-get update && apt-get install -y some-package
# COPY ./my-config /app/my-config

.qwen/sandbox.Dockerfile이 존재하면 Qwen Code를 실행할 때 BUILD_SANDBOX 환경 변수를 사용하여 사용자 정의 샌드박스 이미지를 자동으로 빌드할 수 있습니다:

BUILD_SANDBOX=1 qwen -s

사용 통계

Qwen Code를 개선하기 위해 익명화된 사용 통계를 수집합니다. 이 데이터는 CLI가 어떻게 사용되는지 이해하고, 일반적인 문제를 식별하고, 새 기능의 우선순위를 정하는 데 도움이 됩니다.

수집하는 항목:

• 도구 호출: 호출된 도구의 이름과 범주(네이티브 또는 MCP), 종료 상태(성공, 오류 또는 취소), 실행에 걸린 시간을 기록합니다. 도구에 전달된 인자나 반환된 데이터는 수집하지 않습니다.
• API 요청: 각 요청에 사용된 모델, 요청 지속 시간, 성공 여부를 기록합니다. 프롬프트나 응답의 내용은 수집하지 않습니다.
• 세션 정보: 활성화된 도구 및 승인 모드와 같은 CLI 구성에 대한 정보를 수집합니다.

수집하지 않는 항목:

• 개인 식별 정보(PII): 이름, 이메일 주소 또는 API 키와 같은 개인 정보를 수집하지 않습니다.
• 프롬프트 및 응답 내용: 프롬프트 내용이나 모델의 응답을 기록하지 않습니다.
• 파일 내용: CLI가 읽거나 쓴 파일의 내용을 기록하지 않습니다.

옵트아웃 방법:

settings.json 파일의 privacy 범주에서 usageStatisticsEnabled 속성을 false로 설정하여 언제든지 사용 통계 수집을 옵트아웃할 수 있습니다:

{
  "privacy": {
    "usageStatisticsEnabled": false
  }
}

또는 환경에서 QWEN_USAGE_STATISTICS_ENABLED=false(또는 0)를 설정하세요. 환경 변수가 설정보다 우선합니다. 두 값 중 하나를 변경한 후 Qwen Code를 재시작하세요.