diff --git a/heicode/controller/agent_control_plane_test.go b/heicode/controller/agent_control_plane_test.go
index 41774e54..2b13dacf 100644
--- a/heicode/controller/agent_control_plane_test.go
+++ b/heicode/controller/agent_control_plane_test.go
@@ -1008,6 +1008,9 @@ func TestAgentUserSwarmsAdapterCreatesScopedDeployment(t *testing.T) {
 	recorder := httptest.NewRecorder()
 	ctx, _ := gin.CreateTestContext(recorder)
 	ctx.Set("id", 7)
+	// 蜂群订阅 gate(PR#70):普通用户须有开通蜂群的活跃套餐;admin 绕过(便于测试/运维)。
+	// 本用例聚焦 adapter 的用户作用域,非 gate 本身(gate 见 TestGetUserSwarmEnabled),走 admin 旁路。
+	ctx.Set("role", common.RoleAdminUser)
 	ctx.Set("group", "development")
 	ctx.Request = httptest.NewRequest(http.MethodPost, "/api/swarms", strings.NewReader(string(body)))
 	ctx.Request.Header.Set("Content-Type", "application/json")