To address the global shortage of feed protein, black soldier fly larvae (BSFL) have garnered significant attention as a sustainable alternative protein source. Feeding whole BSFL represents an innovative approach that effectively reduces the high processing costs of dried BSFL powder and prevents nutrient loss during thermal treatment. However, limited research has been conducted on the application of whole BSFL in quail diets. This study aimed to evaluate the effects of incorporating whole BSFL into quail diets on production performance, serum biochemical parameters, immune and antioxidant responses, egg quality, intestinal microbiome and metabolome patterns. In this experiment, 180 quails aged 30-35 days were randomly assigned to four groups, each with three replicates of 15 quails. The experimental diets included 0 %, 10 %, 20 %, and 30 % unprocessed whole BSFL (con, L10, L20, L30), with a 14-day pre-experimental period followed by a 90-day main trial. Results indicated that the inclusion of BSFL significantly reduced the feed-to-egg ratio and enhanced quail production performance. Notably, the L20 group demonstrated significant improvements in liver and kidney function, metabolic levels, antioxidant capacity, and immune performance. Additionally, BSFL positively influenced the amino acid and fatty acid profiles of quail eggs, thereby improving egg quality. While BSFL did not significantly alter the diversity of intestinal microbiota or metabolites, it had a significant impact on protein digestion and absorption as well as mineral uptake. Therefore, we conclude that whole BSFL can serve as a high-quality ingredient in quails feed, with optimal results observed at a 20 % inclusion rate.