Qwen Code

https://qwenlm.github.io/qwen-code-docs/en/
Admin
Qwen Code is an agentic AI-powered coding assistant that runs in your terminal, helping developers...
Tokens:457,637
Snippets:5,720
Trust Score:9.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Start Daemon and Install SDK

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/examples/daemon-client-quickstart

Commands to initialize the daemon in a workspace and install the required Node.js package.

```bash
cd your-project/
qwen serve --port 4170
```

```bash
npm install @qwen-code/sdk
```

--------------------------------

### Install dependencies and start development mode

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/weekly-update-2026-07-02

Install required packages and launch the development environment using bun.

```bash
bun install && bun run dev
```

--------------------------------

### Quick Start with qwen-code-sdk

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/sdk-python

Example of performing an asynchronous query and processing the resulting message stream.

```python
import asyncio
 
from qwen_code_sdk import (
    is_sdk_assistant_message,
    is_sdk_result_message,
    query,
)
 
 
def extract_text(message):
    content = message.get("message", {}).get("content", [])
    if not isinstance(content, list):
        return repr(content)
    texts = [
        block.get("text", "")
        for block in content
        if isinstance(block, dict) and block.get("type") == "text"
    ]
    return "".join(texts) if texts else "[no text content]"
 
 
def print_result(message):
    if message.get("is_error"):
        error = message.get("error") or {}
        print(f"Error: {error.get('message', 'Unknown error')}")
        return
    print(message.get("result", ""))
 
 
async def main() -> None:
    async with query(
        "Explain the repository structure.",
        {
            "cwd": "/path/to/project",
            "path_to_qwen_executable": "qwen",
        },
    ) as result:
        async for message in result:
            if is_sdk_assistant_message(message):
                print(extract_text(message))
            elif is_sdk_result_message(message):
                print_result(message)
 
 
asyncio.run(main())
```

--------------------------------

### Build from Source

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/how-to-use-qwencode-cowork

Manual installation steps requiring Bun to be installed on the system.

```bash
# Install Bun
curl -fsSL https://bun.sh/install | bash
exec /bin/zsh
 
# Clone repository
git clone https://github.com/QwenLM/qwen-code-examples
 
# Enter directory and install
cd qwen-code-examples/apps/qwen-cowork
bun install
 
# Launch
bun run dev
```

--------------------------------

### Install qwen-code-sdk

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/sdk-python

Commands to install the SDK via pip.

```bash
pip install qwen-code-sdk
```

```bash
pip install --pre qwen-code-sdk
```

--------------------------------

### save_memory Examples

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/tools/memory

Examples demonstrating how to store user preferences and project-specific details.

```python
save_memory(fact="My preferred programming language is Python.")
```

```python
save_memory(fact="The project I'm currently working on is called 'qwen-code'.")
```

--------------------------------

### Calculate request_setup_ms

Source: https://qwenlm.github.io/qwen-code-docs/en/design/telemetry-llm-request-timing-design

Formula for calculating the request setup duration based on attempt start and entry time.

```text
request_setup_ms = attemptStart_of_successful_attempt - requestEntryTime;
```

--------------------------------

### Install and run React DevTools

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/contributing

Install and execute the React DevTools utility.

```bash
npm install -g react-devtools@4.28.5
react-devtools
```

--------------------------------

### Install Dependencies

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/extensions/getting-started-extensions

Navigate to the extension directory and install required packages.

```bash
cd my-first-extension
npm install
```

--------------------------------

### Full Configuration Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/followup-suggestions

Example of a complete settings.json configuration including fast model and UI feature flags.

```json
{
  "fastModel": "qwen3-coder-flash",
  "ui": {
    "enableFollowupSuggestions": true,
    "enableCacheSharing": true
  }
}
```

--------------------------------

### SubagentStart Output Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Example output providing additional context during subagent initialization.

```json
{
  "hookSpecificOutput": {
    "additionalContext": "Subagent initialized with restricted permissions."
  }
}
```

--------------------------------

### Install Qwen Code Preview

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/channels-weixin-launch-announcement

Install the required preview version of the Qwen Code CLI globally.

```bash
npm i @qwen-code/qwen-code@0.14.0-preview.0 -g
```

--------------------------------

### Install Qwen Code via Script

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/obsidian

One-click installation commands for different operating systems.

```bash
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"
```

```bash
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat
```

--------------------------------

### Install Skill Packages

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/qwencode-coding-plan-guide-build-website

Use the npx command to globally install specific skill packages for Qwen Code.

```bash
npx skills add <SkillPackageName> -g
```

--------------------------------

### Start Daemon for Verification

Source: https://qwenlm.github.io/qwen-code-docs/en/design/daemon-acp-http/README

Command to start the daemon locally for testing purposes, requiring a token.

```bash
qwen serve --listen 127.0.0.1:0 --token <t>
```

--------------------------------

### Review Rules Configuration Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/code-review

Example content for the .qwen/review-rules.md file used to define custom project review criteria.

```markdown
# Review Rules
 
- All API endpoints must validate authentication
- Database queries must use parameterized statements
- React components must not use inline styles
- Error messages must not expose internal paths
```

--------------------------------

### Install Skill Pack

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/qwencode-bailian-ai-marketing

Command to clone and install the open1v-skills package within the Qwen Code environment.

```bash
帮我安装 open1v-skills 技能包：git clone https://github.com/joeytoday/open1v-skills.git ~/.agents/skills/open1v-skills，然后安装依赖
```

--------------------------------

### Install extension from local path or archive

Source: https://qwenlm.github.io/qwen-code-docs/en/users/extension/introduction

Install extensions from a local directory or compressed archive files.

```bash
qwen extensions install /path/to/your/extension
```

```bash
qwen extensions install /path/to/your/extension.zip
qwen extensions install /path/to/your/extension.tar.gz
```

--------------------------------

### Install or Link a Custom Channel Extension

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/channels/plugins

Use these commands to install a local extension or link it for active development.

```bash
# From a local path (for development or private plugins)
qwen extensions install /path/to/my-channel-extension
 
# Or link it for development (changes are reflected immediately)
qwen extensions link /path/to/my-channel-extension
```

--------------------------------

### Install and build project dependencies

Source: https://qwenlm.github.io/qwen-code-docs/en/users/support/troubleshooting

Run these commands to resolve module import errors by ensuring dependencies are installed and the project is compiled.

```bash
npm install
npm run build
npm run start
```

--------------------------------

### Start documentation development server

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/contributing

Launch the local development server for live previewing.

```bash
npm run dev
```

--------------------------------

### Start the application

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/contributing

Launches the Qwen Code application from the built source code.

```bash
npm start
```

--------------------------------

### GET /file Response

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol

Example response body for reading a text file.

```json
{
  "kind": "file",
  "path": "src/index.ts",
  "content": "export {};\n",
  "encoding": "utf-8",
  "bom": false,
  "lineEnding": "lf",
  "sizeBytes": 11,
  "returnedBytes": 11,
  "truncated": false,
  "hash": "sha256:...",
  "matchedIgnore": null,
  "originalLineCount": null
}
```

--------------------------------

### GET /session/:id/context Response

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol

Example response body for retrieving session context.

```json
{
  "v": 1,
  "sessionId": "<sid>",
  "workspaceCwd": "/canonical/path",
  "state": {
    "models": {},
    "modes": {},
    "configOptions": []
  }
}
```

--------------------------------

### GET /file/bytes Response

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol

Example response body for reading raw bytes from a file.

```json
{
  "kind": "file_bytes",
  "path": "assets/logo.png",
  "offset": 0,
  "sizeBytes": 3912,
  "returnedBytes": 3912,
  "truncated": false,
  "contentBase64": "...",
  "hash": "sha256:..."
}
```

--------------------------------

### Install via Qwen Code Prompt

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/how-to-use-qwencode-cowork

Use this prompt within the Qwen Code interface to automate the installation and launch process.

```text
Help me install the cowork project and launch it, the repository address is: https://github.com/QwenLM/qwen-code-examples
```

--------------------------------

### GET /workspace/preflight Idle Response

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol

Example JSON response when the daemon is idle and no ACP child is active.

```json
{
  "v": 1,
  "workspaceCwd": "/canonical/path",
  "initialized": true,
  "acpChannelLive": false,
  "cells": [
    {
      "kind": "node_version",
      "status": "ok",
      "locality": "daemon",
      "detail": { "version": "22.4.0", "required": ">=22" }
    },
    {
      "kind": "cli_entry",
      "status": "ok",
      "locality": "daemon",
      "detail": { "path": "/usr/local/bin/qwen", "source": "process.argv[1]" }
    },
    {
      "kind": "workspace_dir",
      "status": "ok",
      "locality": "daemon",
      "detail": { "path": "/canonical/path" }
    },
    { "kind": "ripgrep", "status": "ok", "locality": "daemon" },
    {
      "kind": "git",
      "status": "ok",
      "locality": "daemon",
      "detail": { "version": "2.45.0" }
    },
    {
      "kind": "npm",
      "status": "ok",
      "locality": "daemon",
      "detail": { "version": "10.7.0" }
    },
    {
      "kind": "auth",
      "status": "not_started",
      "locality": "acp",
      "hint": "spawn a session to populate"
    },
    {
      "kind": "mcp_discovery",
      "status": "not_started",
      "locality": "acp",
      "hint": "spawn a session to populate"
    },
    {
      "kind": "skills",
      "status": "not_started",
      "locality": "acp",
      "hint": "spawn a session to populate"
    },
    {
      "kind": "providers",
      "status": "not_started",
      "locality": "acp",
      "hint": "spawn a session to populate"
    },
    {
      "kind": "tool_registry",
      "status": "not_started",
      "locality": "acp",
      "hint": "spawn a session to populate"
    },
    {
      "kind": "egress",
      "status": "not_started",
      "locality": "acp",
      "hint": "egress probing lands in PR 14 (#4175)"
    }
  ]
}
```

--------------------------------

### Environment Key Examples

Source: https://qwenlm.github.io/qwen-code-docs/en/design/custom-api-key-auth-wizard-prd

Sample outputs for various protocol and base URL combinations.

```text
Protocol: openai
Base URL: https://api.openai.com/v1
-> QWEN_CUSTOM_API_KEY_OPENAI_HTTPS_API_OPENAI_COM_V1

Protocol: openai
Base URL: https://openrouter.ai/api/v1
-> QWEN_CUSTOM_API_KEY_OPENAI_HTTPS_OPENROUTER_AI_API_V1

Protocol: anthropic
Base URL: https://api.anthropic.com/v1
-> QWEN_CUSTOM_API_KEY_ANTHROPIC_HTTPS_API_ANTHROPIC_COM_V1

Protocol: gemini
Base URL: https://generativelanguage.googleapis.com
-> QWEN_CUSTOM_API_KEY_GEMINI_HTTPS_GENERATIVELANGUAGE_GOOGLEAPIS_COM

Protocol: openai
Base URL: http://localhost:11434/v1
-> QWEN_CUSTOM_API_KEY_OPENAI_HTTP_LOCALHOST_11434_V1
```

--------------------------------

### Configure Feishu Integration

Source: https://qwenlm.github.io/qwen-code-docs/en/blog/qwencode-bailian-ai-marketing

Prompt to initiate the guided setup for connecting Qwen Code to a Feishu group.

```text
帮我配置飞书频道，我想在飞书群里 @机器人 生成商品图和文案，并一步步告诉我步骤
```

--------------------------------

### Start qwen serve

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/daemon/20-quickstart-operations

The basic command to launch the daemon in default loopback mode.

```bash
qwen serve
```

--------------------------------

### Capabilities Response Schema

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/qwen-serve-protocol

Example JSON response for the GET /capabilities endpoint, detailing protocol versions, features, and workspace configuration.

```json
{
  "v": 1,
  "protocolVersions": {
    "current": "v1",
    "supported": ["v1"]
  },
  "mode": "http-bridge",
  "features": ["health", "daemon_status", "capabilities", "..."],
  "modelServices": [],
  "workspaceCwd": "/canonical/path/to/workspace"
}
```

--------------------------------

### Get previous range bounds in TypeScript

Source: https://qwenlm.github.io/qwen-code-docs/en/plans/2025-06-03-stats-dashboard-redesign

Calculates the start and end dates for the time period immediately preceding the provided range. Returns null if the range is set to 'all'.

```typescript
function getPreviousRangeBounds(
  range: TimeRange,
): { start: Date; end: Date } | null {
  if (range === 'all') return null;
  const { start, end } = getTimeRangeBounds(range);
  const durationMs = end.getTime() - start.getTime();
  return {
    start: new Date(start.getTime() - durationMs),
    end: new Date(start.getTime()),
  };
}
```

--------------------------------

### Install an extension

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/extensions/extension

Installs an extension from a GitHub repository or local path. Changes to the source require an update command to reflect in the installed copy.

```bash
qwen extensions install https://github.com/qwen-cli-extensions/security
```

--------------------------------

### Initialize Qwen Code in a Project

Source: https://qwenlm.github.io/qwen-code-docs/en/users/overview

Navigate to your project directory and launch the Qwen Code interface.

```bash
cd your-project
qwen
```

--------------------------------

### Run GitHub Setup Command

Source: https://qwenlm.github.io/qwen-code-docs/en/users/integration-github-action

Execute this command within the Qwen Code CLI to configure GitHub integration.

```text

/setup-github
```

--------------------------------

### Notification Output Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Example of the hook output structure for notifications.

```json
{
  "hookSpecificOutput": {
    "additionalContext": "Notification processed by monitoring system."
  }
}
```

--------------------------------

### Daemon output example

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/daemon/20-quickstart-operations

Expected console output upon successful startup.

```text
qwen serve listening on http://127.0.0.1:4170 (mode=http-bridge, workspace=/your/cwd)
qwen serve: bound to workspace "/your/cwd"
qwen serve: bearer auth disabled (loopback default). Set QWEN_SERVER_TOKEN to enable.
```

--------------------------------

### Control CLI Runtime Process

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/sdk-python

Demonstrates how to initialize a query, inspect supported commands, set permission modes, and switch models during execution.

```python
import asyncio
 
from qwen_code_sdk import is_sdk_result_message, query
 
 
async def main():
    async with query(
        "Inspect this repository and explain the test layout.",
        {
            "cwd": "/path/to/project",
            "path_to_qwen_executable": "qwen",
        },
    ) as result:
        commands = await result.supported_commands()
        print(commands)
 
        await result.set_permission_mode("plan")
        await result.set_model("qwen-plus")
 
        async for message in result:
            if is_sdk_result_message(message):
                if message.get("is_error"):
                    error = message.get("error") or {}
                    print(f"Error: {error.get('message', 'Unknown error')}")
                else:
                    print(message.get("result", ""))
 
 
asyncio.run(main())
```

--------------------------------

### Start Custom Channels

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/channels/plugins

Commands to initialize all configured channels or a specific custom channel instance.

```bash
# Start all channels including custom ones
qwen channel start
 
# Start just your custom channel
qwen channel start my-bot
```

--------------------------------

### PermissionRequest Output Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Example of the hook output structure for permission decisions.

```json
{
  "hookSpecificOutput": {
    "decision": {
      "behavior": "allow",
      "message": "Permission granted based on security policy",
      "interrupt": false
    }
  }
}
```

--------------------------------

### Auto Mode Usage Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode

Example of initiating a task while in Auto Mode.

```text
/approval-mode auto
Refactor the auth module to use OAuth2. Run the full test suite afterwards.
```

--------------------------------

### Build and Link Qwen Code from Source

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/tools/sandbox

Steps to install dependencies, build the project, and create a global symbolic link to the source code directory.

```bash
# 1. First, install the dependencies of the project
npm install
 
# 2. Build the Qwen Code project
npm run build
 
# 3. Verify that the dist directory has been generated
ls -la packages/cli/dist/
 
# 4. Create a global link in the CLI package directory
cd packages/cli
npm link
 
# 5. Verification link (it should now point to the source code)
which qwen
# Expected output: /xxx/xxx/.nvm/versions/node/v24.11.1/bin/qwen
# Or similar paths, but it should be a symbolic link
 
# 6. For details of the symbolic link, you can see the specific source code path
ls -la $(dirname $(which qwen))/../lib/node_modules/@qwen-code/qwen-code
# It should show that this is a symbolic link pointing to your source code directory
 
# 7.Test the version of qwen
qwen -v
# npm link will overwrite the global qwen. To avoid being unable to distinguish the same version number, you can uninstall the global CLI first
```

--------------------------------

### Test full worktree lifecycle: start, write, keep, and resume

Source: https://qwenlm.github.io/qwen-code-docs/en/e2e-tests/worktree-phase-d

Demonstrates creating a session, writing a file, keeping the worktree, and resuming the session via tmux.

```bash
SESSION_ID=$(uuidgen)
tmux new-session -d -s g1 -x 200 -y 50 \
  "cd $TEST_DIR && $QWEN --worktree g1-test --session-id $SESSION_ID --approval-mode yolo 2>&1 | tee /tmp/g1-stderr.out"
sleep 3
tmux send-keys -t g1 "use the write_file tool to create file 'work.txt' with content 'phase d test'"
sleep 0.3; tmux send-keys -t g1 Enter
sleep 8
 
tmux send-keys -t g1 C-c; sleep 0.3; tmux send-keys -t g1 C-c; sleep 1
tmux send-keys -t g1 Enter   # default = "Keep"
sleep 2
tmux kill-session -t g1
 
# File survived
cat "$TEST_DIR/.qwen/worktrees/g1-test/work.txt"
 
# Resume reattaches
tmux new-session -d -s g1b -x 200 -y 50 \
  "cd $TEST_DIR && $QWEN --resume $SESSION_ID --approval-mode yolo"
sleep 4
tmux capture-pane -t g1b -p -S -50 | grep -E "⎇ worktree-g1-test|Resumed"
tmux kill-session -t g1b
```

--------------------------------

### Start Telegram Channel

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/channels/telegram

Commands to start the Telegram channel or all configured channels.

```bash
# Start only the Telegram channel
qwen channel start my-telegram
 
# Or start all configured channels together
qwen channel start
```

--------------------------------

### Install extension from archive URL

Source: https://qwenlm.github.io/qwen-code-docs/en/users/extension/introduction

Install extensions from remote compressed archive files.

```bash
qwen extensions install https://example.com/your/extension.zip
qwen extensions install https://example.com/your/extension.tar.gz
```

--------------------------------

### Setup test environment for PR worktree tests

Source: https://qwenlm.github.io/qwen-code-docs/en/e2e-tests/worktree-phase-d

Initializes a temporary directory and clones the qwen-code repository to serve as the test environment.

```bash
# Use qwen-code itself as the test repo
TEST_DIR=$(mktemp -d -t qwen-wt-phd-pr-XXXXXX)
TEST_DIR=$(cd "$TEST_DIR" && pwd -P)
cd "$TEST_DIR"
git clone --depth 1 https://github.com/QwenLM/qwen-code.git .
PROJECT_ID=$(node -e "console.log(process.argv[1].replace(/[^a-zA-Z0-9]/g,'-'))" "$TEST_DIR")
```

--------------------------------

### Install extension from Git repository

Source: https://qwenlm.github.io/qwen-code-docs/en/users/extension/introduction

Install an extension directly from a Git repository URL.

```bash
qwen extensions install https://github.com/github/github-mcp-server
```

--------------------------------

### Install dependencies

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/contributing

Installs all required dependencies defined in the root and package-specific package.json files.

```bash
npm install
```

--------------------------------

### Launch recipes

Source: https://qwenlm.github.io/qwen-code-docs/en/developers/daemon/20-quickstart-operations

Various configurations for starting the daemon, including authentication, networking, and performance tuning.

```bash
# 1. Local dev default (loopback, no token)
qwen serve
 
# 2. Explicit workspace + ephemeral port
qwen serve --workspace /path/to/repo --port 0
 
# 3. Hardened loopback development (force bearer even on loopback)
QWEN_SERVER_TOKEN=$(openssl rand -hex 32) qwen serve --require-auth
 
# 4. Expose to LAN (non-loopback requires a token)
QWEN_SERVER_TOKEN=$(openssl rand -hex 32) \
  qwen serve --hostname 0.0.0.0 --port 4170
 
# 5. Tune for many sessions and a larger replay ring
qwen serve --max-sessions 0 --event-ring-size 32000
 
# 6. Multi-client collaboration + strict MCP budget
QWEN_SERVER_TOKEN=secret \
  qwen serve --require-auth \
             --mcp-client-budget 10 \
             --mcp-budget-mode enforce
 
# 7. Start with a consensus policy configured in settings.json
# settings.json: { "policy": { "permissionStrategy": "consensus", "consensusQuorum": 2 } }
qwen serve
 
# 8. Debug logging
QWEN_SERVE_DEBUG=1 qwen serve
 
# 9. Disable the F2 pool (fallback to per-session MCP clients)
QWEN_SERVE_NO_MCP_POOL=1 qwen serve
 
# 10. Allow browser web UI cross-origin access
QWEN_SERVER_TOKEN=secret \
  qwen serve --allow-origin 'http://localhost:3000'
 
# 11. Prompt deadline + SSE idle timeout
qwen serve --prompt-deadline-ms 300000 --writer-idle-timeout-ms 600000
 
# 12. Keep the ACP child warm after the last session closes
qwen serve --channel-idle-timeout-ms 60000
 
# 13. Enable HTTP rate limiting
QWEN_SERVE_RATE_LIMIT=1 qwen serve
```

--------------------------------

### TodoCreated Configuration Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Example configuration for registering a command-based hook for TodoCreated events.

```json
{
  "hooks": {
    "TodoCreated": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$HOME/.qwen/hooks/todo-validator.sh",
            "name": "todo-validator",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}
```

--------------------------------

### Enable Sandboxing via CLI and Settings

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/sandbox

Demonstrates enabling the sandbox using command flags, environment variables, and the settings.json file.

```bash
# Enable sandboxing with command flag
qwen -s -p "analyze the code structure"
 
# Or enable sandboxing for your shell session (recommended for CI / scripts)
export QWEN_SANDBOX=true   # true auto-picks a provider (see notes below)
qwen -p "run the test suite"
 
# Configure in settings.json
{
  "tools": {
    "sandbox": true
  }
}
```

--------------------------------

### TodoCreated Output Examples

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Examples of allow and block responses for todo creation hooks.

```json
{
  "decision": "allow",
  "reason": "Todo content validated successfully"
}
```

```json
{
  "decision": "block",
  "reason": "Todo content too short. Minimum 5 characters required."
}
```

--------------------------------

### PreCompact Output Example

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks

Example output providing additional context before compaction occurs.

```json
{
  "hookSpecificOutput": {
    "additionalContext": "Compacting conversation to maintain optimal context window."
  }
}
```

--------------------------------

### Initialize Qwen Code with regular files

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/dual-output

Sets up Qwen Code to use regular files for input and event output.

```bash
touch /tmp/qwen-events.jsonl /tmp/qwen-input.jsonl
qwen \
  --json-file /tmp/qwen-events.jsonl \
  --input-file /tmp/qwen-input.jsonl
```

--------------------------------

### Uninstall standalone installation

Source: https://qwenlm.github.io/qwen-code-docs/en/users/support/Uninstall

Executes the uninstallation script for standalone installations, preserving configuration files.

```bash
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/uninstall-qwen-standalone.sh | bash
```

```powershell
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/uninstall-qwen-standalone.ps1 | iex
```

--------------------------------

### Enable LSP via Command Line

Source: https://qwenlm.github.io/qwen-code-docs/en/users/features/lsp

Use the experimental flag to activate LSP functionality during startup.

```bash
qwen --experimental-lsp
```

--------------------------------

### Commit changes for install state

Source: https://qwenlm.github.io/qwen-code-docs/en/superpowers/plans/2026-05-28-computer-use-built-in

Commit the newly created install state files to the repository.

```bash
git add packages/core/src/tools/computer-use/install-state.ts packages/core/src/tools/computer-use/install-state.test.ts
git commit -m "feat(computer-use): persist install approval state under ~/.qwen"
```

--------------------------------

### Clear Install State

Source: https://qwenlm.github.io/qwen-code-docs/en/plans/2026-05-28-computer-use-built-in

Removes the local computer-use configuration directory to reset the installation state.

```bash
rm -rf ~/.qwen/computer-use
```

--------------------------------

### Call Site Initialization Logic

Source: https://qwenlm.github.io/qwen-code-docs/en/design/performance/fire-and-forget-startup-prefetch

Example of how to determine whether to defer the IDE connection based on the current application mode and configuration.

```typescript
const deferIdeConnection =
  config.isInteractive() && !config.getExperimentalZedIntegration() && !input;
 
const initializationResult = await initializeApp(config, settings, {
  deferIdeConnection,
});
```

--------------------------------

### Initialize Test Environment

Source: https://qwenlm.github.io/qwen-code-docs/en/e2e-tests/worktree-phase-d

Sets up a temporary git repository and configures the QWEN environment variable for testing.

```bash
TEST_DIR=$(mktemp -d -t qwen-wt-phd-XXXXXX)
TEST_DIR=$(cd "$TEST_DIR" && pwd -P)   # resolve symlinks (macOS /var → /private/var)
cd "$TEST_DIR"
git init -q -b main
git config user.email t@e.com
git config user.name t
git config commit.gpgsign false
echo "hello" > README.md
git add README.md
git commit -q -m "initial" --no-verify
 
PROJECT_ID=$(node -e "console.log(process.argv[1].replace(/[^a-zA-Z0-9]/g,'-'))" "$TEST_DIR")
QWEN="node /Users/mochi/code/qwen-code/.claude/worktrees/tender-jemison-037f0a/dist/cli.js"
```
Tokens:
Raw